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ant to unlock the power 
of PowerPC’ microprocessors? 


Here's the key. 






If you want to crank out code that really 
screams on PowerPC microprocessor- 
based systems, then it helps to work with 
the experts who know the PowerPC 
Architecture™ inside and out— Motorola. 
Motorola’s Software Development Kits 
for Power Macintosh™ leverage our experi- 
ence as one of the creators of the PowerPC 
Architecture. We know how to get the 
highest possible performance out of every 
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member of the PowerPC family, including 
the PowerPC 603™ and PowerPC 604™ 
microprocessors. And we build that exper- 
tise into our highly optimizing C/C++ and 
FORTRAN compilers. They’ll streamline 
your code, so your applications run cleaner 
and faster. And that can give them the edge 
in the marketplace. 

And now, when you license a Motorola 
C/C++ or FORTRAN SDK for only $349 


Mac OS 


se 1.0/ MPW Version 





you'll get the complete Apple® MPW environ- 
ment, as well as free upgrades for a full year. 

So contact Motorola for more informa- 
tion, or to order your own Macintosh® SDK. 
And unlock the power inside PowerPC 
microprocessors. 


Call 1-800-347-8384 or 1-512-891-2999. 


Internet: ppcinfo@pets.sps.mot.com 

WWW: http://www.mot.com/PowerPC 

Applelink: motosoftware@applelink.apple.com 
*Suggested list price in U.S. dollars. Subject to change. 


(AA) MOTOROLA 


& are registered trademarks of Motorola, Inc. PowerPC, PowerPC 603, PowerPC 604, PowerPC Architecture and the PowerPC logo are trademarks of 
International Business Machines Corp., and are used under license therefrom. Power Macintosh, Mac and the Mac OS logo are trademarks, and Apple and Macintosh are registered trademarks, of Apple Computer, Inc. 





Now, create 68K and Power Macintosh 
applications faster than ever before. VIP-C’s 
visual design, its application building aids, and 
its ability to let you modify your program code 
and interface with immediate feedback, give you 
a real programming edge. Read further to see 
why, with VIP-C, time really is on your side... 


Complete Development System 

Now develop with just one comprehensive 
system. VIP-C integrates all the tools you need 
to create stand-alone 68K and Power Macintosh 
applications—tight out of the box! Develop 
applications in a standard language using this 
intelligent, full-featured Rapid Application — 
Development (RAD) environment. No more 
moving from tool to tool. No more dependence 
on non-standard languages. 


For All Levels of Programmers 
VIP-C offers multiple levels of support to 
best fit your abilities. If you just want to type C 

code into its editor, you can—and VIP-C will 
automatically check the syntax and create a 
flowchart of your code. For higher-level support, 
VIP-C features prewritten intelligent prototypes 
of all the Mac Toolbox calls, high-level VIP-C 
Functions that simplify low-level Toolbox calls, 
Resource Editors that let you visually design and 
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efficient and reliable application framework—all 
in one complete development environment. 


User Interface Generation Tools 

The VIP-C Dispatcher simplifies program 
development by automating the main event 
loop. It acts as a central controller to manage 
program events by distributing tasks to different 
routines. User interface items—menus, dialogs, 
buttons, etc.—are created with integrated _ 
resource editors that automatically link user 
action to your code. 


VIP-C 1.5 


Everything you need to 
create complete Macintosh and 
Power Macintosh applications 

in one box. 


Powerful Prewritten Functions 
_ Functions for the most frequently used 
features of the Mac interface have been 
prewritten and stored in a palette for instant 
use. With the click of a mouse you can lighten 


Search and display prototypes for any function, 
structure, or macro. No more rooting through | 


Attention Database Developers! 
VIP-C users now have the power to create 
commercial quality, multi-user, relational 
databases using the new VIP Database Manager 
(sold separately). VIP Database Manager has the 
built-in functionality of the CXBase Pro 
database engine (recently chosen by Apple OSA 
for creating the eWorld content publishing 
software) giving you an inexpensive way to 
create professional databases, royalty-free! 
~ Compiler Hotlink 
If you have a favorite compiler, use it! 
Compile and run your application directly from a 
menu item in the VIP-C editor. VIP-C supports: 


_ THINK C, MPW-C, and CodeWarrior (each 
sold separately). 


Accelerated for 
Power Macintosh s 


Buy VIP-C now for a Limited-_ 
Time Special Price of only $295. 
Act now and get VIP Database 
for 

VIP-C’s suggested retail price is $495. But 
from now until July 31, 1995, you can order 


VIP-C for $295. Call Mainstay to order today. 
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(805) 484-9400 


(800) 484-9817 Ext. 8472 
591-A Constitution Ave. 








M A 
A publication of XPLAINCORPORATION 


How To Communicate With Us 





For Macintosh 
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In this electronic age, the art of communication has become both easier and more complicated. Is it any surprise that we prefer e-mail? If you have 
any questions, feel free to call us at 310/575-4343 or fax us at 310/575-0925. 






































































































































DEPARTMENTS Internet eWorld CompuServe AppleLink America Online 
Orders, Circulation, custservice@xplain.com | MT. CustSvc [ 71333,1063 MT.CUSTSVC MT CUSTSVC 
& Customer Service 
Editorial ' editorial@xplain.com MT Editors 713331065 MT.EDITORIAL MT EDITORS 
Programmer’s Challenge progchallenge@xplain.com MT.PrgChal 71552,174 MT.PROGCHAL MT PRGCHAL 
Ad Sales ~~ adsales@xplain.com MT.AdSales ~)-71552,172 MT-.ADSALES | MT ADSALES 
Online Support online@xplain.com MT.Online |= _ aa i 
Accounting accounting@xplain.com accounting@xplaincom  =§ — _ i 
Marketing marketing@xplain.com MT.Mktg |= - — 

Press Releases pressreleases@xplain.com pressreleases@xplain.com | - _ ~ 

General info@xplain.com info@xplain.com  71333,1064 MACTECHMAG MacTechMag 

Online support area ftp://ftp.netcom.com/pub/xp/xplain | use shortcut: type see Third Parties: | use keyword: 
MACTECH GO MACTECHMAG Third Parties (H-O) | MACTECHMAG 














MACTECH MAGAZINE 
Editor-in-Chief/Publisher ¢ Neil Ticktin 
Editor-at-Large ¢ Scott T Boyd 

Associate Editor ¢ Mary Elaine Califf 

Editorial Assistant ¢ John Kawakami 
Advertising Executive ¢ Ruth Subrin 

Art Director ¢ Judith Chaplin, Chaplin & Assoc. 


AUTHORS & REGULAR CONTRIBUTORS 


MacTech Magazine is grateful to the following individuals who contribute 
on a regular basis. We encourage others to share the technology. We are 
——— dedicated to the distribution of useful programming information without 
regard to Apple’s developer status. For information on submitting articles, ask us for our 
writer’s kit which includes the terms and conditions upon which we publish articles. 





XPLAIN CORPORATION Richard Clark David R. Mark Mike Scanlin 
VP Finance & Operations * Andrea J. Sniderman General Magic M/MAC Programmer's Challenge 


Mountain View, CA Arlington, VA Mountain View, CA 


Customer Service ¢ Al Estrada 
Software Engineer ¢ Don Bresee 


Accounting Assistant ¢ Brian Shin Chris Espinosa Jordan Mattson Symantec Technical 


Administrative Assistant ¢ Susan Pomrantz Apple Computer, Inc. Apple Computer, Inc. Support Group 
Board of Advisors ¢ Blake Park, Alan Carsrud apenas a ok 


MacTech Magazine (ISSN: 1067-8360 / USPS: 010-227) is published monthly by 
Xplain Corporation, 1617 Pontius Avenue, 2nd Floor, Los Angeles, CA 90025-9555. Voice: 
310/575-4343, FAX: 310/575-0925. Domestic subscription rates are $47.00 per year. 
Canadian subscriptions are $59.00 per year. All other international subscriptions are 
$97.00 per year. Domestic source code disk subscriptions are $77 per year. All 
international disk subscriptions are $97.00 a year. Please remit in U.S. funds only. 
Second Class postage is paid at Los Angeles, CA and at additional mailing office. 

POSTMASTER: Send address changes to MacTech Magazine, P.O. Box 250055, Los 
Angeles, CA 90025-9555. 


The names MacTech, MacTech Magazine, MacTutor and 
the MacTutorMan logo are trademarks and registered 
trademarks of Xplain Corporation. All contents are 
copyright 1984-1995 by Xplain Corporation. All rights 
reserved. Trademarks appearing in MacTech Magazine 
remain the property of the companies that hold license. 


Ge ) PRINTED WITH 


we Printed on recycled paper. : SOY INK . 


THE STAFF 


MACTECHMAGAZINE ® JUNE 1995 


py \:) 5 eels 
CONTENTS 





June 1995 ¢ Volume 11, No. 6 


GETTING STARTED 


— By Dave Mark 





CLIENT/SERVER DATABASES 

An Introduction to Client/Server Database Development 
A review of the technolgies behind a revolution 

— By Liam Breck, Northampton, MA 





APPLYING APPLE TECHNOLOGY 


Add an advanced feature to this popular framework 





— By Jeremy Roschelle 


TOOLS OF THE TRADE 





New Native Power Mac & 68K Development Environments 
— By Rich Parker, Modesto, CA 


SYMANTEC. # SYMANTEC TOP 10... ccc eee eee 


— By Michael Hopkins and Craig Conner, Symantec Corp. 


PROGRAMMERS’ CHALLENGE 


— By Bob Boonstra and Mike Scanlin 


— By John Kawakami, online@xplain.com. 





JuNE 1995 @© MACTECHMAGAZINE 


Sprocket Menus, Part 2 ....... ccc ccc ce cee ceeceeceeeee 


Powering Up AppleEvents in PowerPlant ............... 


Symantec C++ v8.0 is Here! 0.0... cece e eee eee eee n ones 


Goodbye From Mike .......... ccc cece cece cece ce eeeeee 


UNIFORM RESOURCE LOCATORS............... 


For Macintosh 
Programmers & Developers 


























one a 6 Se a vi 
VIEWPOINTS 
4 
joeweeu Ze 
NEWSBITS 
68 
saa ear at as 33 DIALOG BOX 
69 
THE CLASSIFIEDS 
syaeeseee 47 67 
MAIL ORDER STORE 
saree ace 57 72 
60 ADVERTISER & 
oe PRODUCT INDEX 
71 
hero wh Ge 66 
TIPS & TIDBITS 
80 


TABLE OF CONTENTS El 








By Scott T Boyd, Editor-at-Large 
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WHO’s THAT KNOCKING AT THE Door? 


Microsoft wants you to know about their upcoming new 
version of MacOLE. They want you to know so badly that 
they're going door to door to spread the word. Well, at least 
they showed up at my door, PowerMac in hand and sales pitch 
all warmed up and ready to deliver. 

Might this have something to do with a certain 
endorsement seen here last month? 

While some have labeled our endorsement “precipitous”, 
we've given it some long and hard thought. It comes down to 
this - OpenDoc provides an architecture, OLE offers a 
specification. Users may have a hard time telling the difference, 
but developers we've talked to haven’t. In fact, many of our 
readers have told us that they looked at OLE long enough to 
decide that they'd better go learn OpenDoc. 

I don’t believe that it’s just a matter of Macintosh bigotry 
(although, for the record, I’ve got no problem with that). The 
comments we've received have focused on the specific needs of 
our developers, and which technology delivers more to satisfy 
those needs. It goes beyond feature set wars to the architectural 
issues. OpenDoc delivers on providing a component architecture. 
Now if Apple will finish it up and ship it, we can get on about the 
business of demanding the tools we'll need to use it. 


GUERRILLA MARKETING 
Microsoft’s success in the marketplace clearly has little to do 
with the quality of their products. Most of us know and accept 
that DOS/Windows has never been on par with Macintosh, yet 
we also know and accept that the lesser technology has swept 
the marketplace. 

Judge Stanley Sporkin seems to believe that it may not all be 
the result of superior products and outstanding marketing; rather, it 
might have something to do with overzealous OEM arrangements. | 
don’t know about any of that, but I do know about some energetic 
marketing efforts. Having met an unexpected visitor from Redmond 
at my front door mere minutes after waking up, I can safely confirm 
that Microsoft wants your attention focused on OLE, not OpenDoc. 

Microsoft prevails in the marketplace. If it’s not the 
products, maybe it’s the guerrilla marketing. 


So WuHaT? 
Normally this episode wouldn’t rate a mention, but it occurs to 
me that it demonstrates an interesting difference between how 
Microsoft and Apple each deals with developers. 

Microsoft gets in our editorial faces. They want your 
attention, and getting us to write about their stuff is a good way 
for them to get to you. Apple, on the other hand, takes a 
slightly different approach with us, and hence with you. They 
just don’t get in touch all that often. Why the difference? 


4 | VIEWPOINT 


Microsoft clearly encourages bold behavior. They reward 
aggressive maneuvers. On the other hand, I don’t see anyone 
from Apple showing up at my front door. It’s not that I want 
them dropping in (I don’t), but Microsoft has shown a great 
deal of initiative (remember those CDs? the MacWorld class on 
Windows for Mac programmers? the Windows 95 for Mac 
programmers pre-conference at MacHack?). 

It’s not just how they deal with us here at the magazine, 
other examples come to mind as well. For example, contrast the 
following seeding strategies. Microsoft has sent out complete 
Windows 95 kits, unsolicited mind you, to various Macintosh 
developers. Why? According to their cover letter, they thought 
Macintosh developers might find it interesting. On the other 
hand, Apple recently sent out a note that initial Copland seeding 
would go only to Apple Partners. It went on to mention that 
non-partners could see about getting seeded by simply upping 
their status to Partner (and forking over the accompanying fee). 


WoRLD DOMINATION OR BUST 

Microsoft is hellbent on world domination. That mandates going 
after every conceivable developer. Maybe that’s why they’re after 
you — you're not working for Microsoft yet. This firm resolve to 
win the hearts and development environments of each and every 
developer makes for a clear mission and goes a long way towards 
explaining why they’re going out of their way to win you over. 

What is Apple hellbent on? A few more market share 
points? Is it that Apple thinks developers simply aren’t that 
important, or is it that they’re so busy that they've forgotten to 
take the time to realize the value of third-party developers? 


NOTE TO APPLE 

Listen up, Apple. You've got a lot of Macintosh bigots out here, 
and we're starting to notice that you haven't been paying much 
attention to us lately. It’s time that Apple learn a lesson from 
Microsoft — developers matter. They matter so much that the 
company must mandate that time and attention be spent staying 
in their faces. Microsoft provides a reference point for how 
much time and attention one such company thinks developers 
are worth. We've put ourselves and our businesses on the line 
with the Macintosh. Don’t wait to wake up one day and 
wonder where everyone’s gone. 


FooD For THOUGHT 
Software is like milk. It gets old and expires. 
— Keith Cox, R@apple.com 
Maybe that’s why software updates are selling so well! 
— Scott T Boyd, scott@hax.com 
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Bringing software into the world is a little 
like bringing up children. You always know 
where they start, but you seldom know 
where they’ll end up. These days, with 
illegal use of software so common, 
concerned developers have good reason to 
worry about the products of their labor. 
That’s where MacHASP comes in. 





Like a responsible babysitter, MacHASP 
accompanies your software wherever it goes. 
With MacHASP there, your software won't 
run out of control. Without MacHASP, in 
fact, your software won't run at all. 


For developers, MacHASP provides the 
highest level of security and reliability. 

For legitimate users, MacHASP is a friendly 
and transparent solution. Once connected, 
they won’t even feel it’s there. 


And if your child wants to play with 

its friends, a single Net-MacHASP lets it 
run free around a local area network. But 
always under your supervision and control. 


Get serious about software 
protection. Since 1984, nearly one 
million HASP keys have enabled thousands 
of PC & Mac software developers, in more 
than 60 countries, to protect their software. 
To find out why MacHASP is considered the 
best product in the market, order your 
MacHASP Developer’s Kit today. 


1-800-225-4277 


wavb) 8) 


The Professional's Choice 


North Aladdin Software Security Inc. 
America Tel: (800) 223 4277, 212-564 5678 
Fax: 212-564 3377 
E-mail: sales@hasp.com 


Intl Office Aladdin Knowledge Systems Ltd. 
Tel: 972-3-537 5795, Fax: 972-3-537 5796 
AppleLink: ALADDIN.KNOW 
E-mail: aladdin @aladdin.co.il 


United Aladdin Knowledge 
Kingdom Systems UK Ltd. 
Tel: 0753-622266, Fax: 0753-622262 


France Aladdin France SA 
Tel: 1 40 85 98 85, Fax: 1 41 21 90 56 





= Australia Conlab 3 8985685 Mf Benelux Aladdin Benelux 080 782098 M Czech Atlas 2 706085 M Chile Micrologica 2 222 1388 
= Denmark Berendsen 39 577100 M Egypt Zeineldein 2 3604632 Mi Finland [D-Systems 0 870 3520 M& Germany CsS 201 278804 
mw Greece Unibrain 1 6856320 Ml Italy Partner Data 2 26147380 @ Japan Athena 3 58 213284 lM Korea Dae-A 2 848 4481 ll Mexico SiSoft 5 5439770 
= New Zealand Training 4 5666014 M Poland Systherm 61 480273 M@ Portugal Futurmatica 1 4116269 M South Africa D Le Roux, 11 886 4704 
m Spain PC Hardware, 3 4493193 Ml Switzerland Opag 61 7169222 M Taiwan Teco 2 555 9676 & Turkey Mikrobeta 312 467 7504 








t's the highly-regarded industry 

standard, used by more developers 
than any other Macintosh develop- 
ment system. And now it’s been 
totally re-engineered for Power Mac. 

Introducing Symantec C++™ 8.0 
for native Power Mac. 

Not since the original THINK 
C™ has anything so dramatically 
boosted your productivity. There’s a 
Visual Architect™ to generate GUI 
code instantly. An advanced Project 
Manager to handle the largest and 
most complex jobs. Plus native 


Power Mac tools for radically 
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THE INDUSTRY STANDARD JUST MOVED To A HIGHER POWER. 
SYMANTEC C++ 8.0 FOR POWER MAC. 





improved performance. 


DRAW ON THE 
INDUSTRY STANDARD. 


With Symantec C++ 8.0, you sim- 
ply draw the user interface — including 
windows, dialogs, controls, icons and 
menus. Then the built-in Visual 
Architect generates the code with the 
click of a mouse. Now you can spend 
more time on what really sets your 


application apart — its functionality. 


A HIGHER STANDARD 
FOR SPEED. 


The new high-performance com- 
piler is dramatically faster than the 
previous version, so you can become 
more productive than ever. 

And for even more power, we've 


added an Advanced Project Manager. It 


gives you drag and drop so you can eas- 
ily add files, Named Option Sets for 
changing complex sets of options fast, plus 
support for even the largest applications. 

There’s also a new editor and a 
browser for modifying and navigating 


source files, a new debugger, an 


New: Fast C 
AND C++ COMPILERS 
for both Mac and Power Mac 


New! VISUAL ARCHITECT 












SYMANTEC. 


Price good in U. S. only. For more information in Canada, call 1-800-667-8661, ext. 5513. In Australia, call 2-879-6577. In Europe, call 31-71-353111. Symantec C++, Visual Architect, 
THINK Class Library are trademarks of Symantec Corporation. All other trademarks are the property of their respective holders.© 1995 Symantec Corporation. All rights reserved. 








incremental linker, THINK Class 
Library™ 2.0 and much more. 


A DOUBLE STANDARD FOR 
68K AND Power Mac. 


Symantec C++ 8.0 is the first 
















native Mac/Power Mac development 





system to support C++ templates, 





nested classes and multiple inheri- 


tance, as well as ANSI C. Plus 8.0 









includes version 7.0 for 68K support. 
This double standard gives you 
everything you need for both 68K 





and Power Mac development. 
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| cal 1-800-628-4777 Bet. 9H121. 


Be sure to ask about the Symantec 







Developers Advantage Program 
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By Dave Mark, MacTech Magazine Regular Contributing Author 








Sprocket Menus, Part 2 





Last month, we explored Sprocket’s 
menu handling mechanism. We took 
advantage of the ‘CMNU’ resource to 
create menus with command numbers 
attached to each menu item. We loaded 
the ‘CMNU’ menus and registered the 
commands by calling the TMenuBar 
classes’ GetMenuFromCMNU () 
method. We edited the routine 
HandleMenuCommand () in the file 
SprocketStarter.cp to dispatch 
these commands. If any of this seems a 
little hazy, you might want to take a few 
minutes to review last month’s column. 

Two months ago, we built a 
TPictureWindow class that 
implemented a Drag Manager-friendly 
PICT window. This month, we’re going 
to add a new class to our Drag 
Manager example. We'll add a 
TTextWindow class that is also Drag 
Manager friendly. In addition to 
supporting two different window types, 
the application will place a different 
menu in the menu bar, depending on 
the type of the front-most window. 

Let’s get started... 


SPROCKET RESOURCES 

We'll base this month’s program on the 
Sprocket labeled “Sprocket.02/01/95” 
and the SprocketStarter labeled 
“SprocketDragger.02/01/95”. First make 
sure you have both of these folders. 
Now make a copy. of the 
SprocketDragger folder, calling it 
“SprocketPicText.03/25/95”. Since we 
won't be making any changes to 
Sprocket, there’s no need to make a 
copy of the Sprocket folder. 
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Launch your favorite resource editor and open the file 
StandardMenus.rsrc inside your Sprocket folder. Copy 
the ‘CMNU’ resource with an ID of 129 (the one that 
implements the File menu), then close 
StandardMenus.rsrc. 

Now go into the SprocketPicText folder and open the 
resource file SprocketStarter.rsrc. Youll be creating all 
your Sprocket resources in SprocketStarter.rsrc. If you 
can avoid it, try not to modify any other Sprocket resources. At the 
very least, keep those changes to a minimum. If you can avoid 
changing your master Sprocket folder, you'll be able to get by with 
a single, Sprocket folder shared by all your Sprocket applications. 

Paste the “CMNU’ you copied from 
StandardMenus.rsrc into SprocketStarter.rsrc. 
Change the resource ID from 129 to 1000. Be sure to change the 
ID in both places (Get Resource Info from the Resource menu 
and Edit Menu & MDEF id from the MENU menu). Wherever 
possible, you'll number all your resource Ids starting at 1000. 

Change the first item in this ‘CMNU’ from New to New 
Text Window and change the item’s command number 
(Cmd-Num) to 1000. Insert a new, second item reading New 
Picture Window with a command number of 1001. Figure 1 
shows a ResEdit screen shot of the File ‘CMNU’. 


=== CMNU “File Menu” ID = 1000 from SprocketStarter.rsre === 
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Figure 1. The File ‘CMNU’ resource. 


Edit ‘MBAR’ 128, changing the second entry from 129 to 
1000. We'll be including our own copy of the File ‘CMNU”’ in 
the menu bar instead of the original. Notice that we did this 
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without making a change to any of the Sprocket resource files. 
Duplicate ‘WIND’ 1028, change its ID to 1029 and its 
window title from Picture Window to Text Window. This 
‘WIND’ will serve as the template for new text windows. 
Create a new ‘STR’ resource with an ID of 1000 and 
containing the text “<Default Text>” (without the 
quotes). This text will appear in the text window before any 





66 4 single Sprocket folder shared by 
all your Sprocket applications. 4 





text has been dragged into it. 

Create two new ‘CMNU’ resources, one with an ID of 
1001 and the other with an ID of 1002. Be sure to change the 
Ids in both places. ‘CMNU’ 1001 has a title of Picture and 
contains two items. Item 1 is Centered, has a check mark 
next to it and has a command number of 1001. Item 2 is 
Upper Left, has no mark next to it, and has a command 
number of 1002. 

‘CMNU’ 1002 has a title of Text and contains three 
items. Each of these items has a submenu. Item 1 is F ont, 
has a command number of 1003, and uses submenu 131. Item 
2 is $ize, has a command number of 1004, and uses submenu 
132. Item 3 is Style, has a command number of 1005, and 
uses submenu 133. You can find all three of these submenus 
in StandardMenus.rsrc. We'll use them as is. 


SOURCE CODE: TEXTWINDOW.CP 
Create a new source code window, save it in the 
SprocketPicText.03/25/95 folder, inside the SprocketStarter 
subfolder, as TextWindow.cp (you'll find the file 
PictWindow.cp in this same folder). Add 
TextWindow.cp to the project. Here’s the source code: 


const short 
COnSst short 


kTextWindowTemplateID = 1029; 
kDefaultSTRResID = 1000; 


finclude "TextWindow.h" 
finclude <ToolUtils.h> 
MenuHandle TTextWindow: :fgMenu; 


unsigned long TTextWindow::fgWindowTitleCount = 0: 


TTextWindow: : TTextWindow() 

{ 
fDraggedTextHandle = nil; 
TTextWindow: :fgWindowTitleCountt+; 
this->CreateWindow(); 


} 


TTextWindow: :~TTextWindow() 
{ 


Ei SPROCKET MENUS, ParT 2 : 


WindowPtr 
TTextWindow: :MakeNewWindow( WindowPtr behindWindow ) 
{ 

WindowPtr aWindow: 

Str255  titleString; 

GrarPtr savedPort:; 


GetPort(&savedPort); 


aWindow = GetNewColorOrBlackAndWhiteWindow/( kTextWindowTemplatelID, 
nil, behindWindow ); 


if (aWindow) 


GetWTitle(aWindow, titleString) ; 
if (StrLength(titleString) != 0) 
{ 

Str255 numberString; 


NumToString( fgWindowTitleCount, numberString ); 

BlockMove (&numberString [1] ,étitleString[titleString [0]+1], 

numberString[0]); 
titleString[0] += numberString [0]; 

} 

SetWTlitle(aWindow, titleString) ; 





SetPort (aWindow) ; 
ShowWindow(aWindow) ; 
SetPort(savedPort) ; 


return aWindow: 


} 


void 
TTextWindow: :Draw(void) 


Rect £4 

char ‘*textPtr; 
long textLength; 
Handle stringH; 


r = fWindow->portRect; 
EraseRect( &r ): 


if ( fDraggedTextHandle == nil ) 
{ 
stringH = (Handle)GetString( kDefaultSTRResID ): 


if ( stringH == nil ) 
return; 


HLock( stringH ); 


textPtr = &((*stringH) [1]); 
textLength = (long) ((*stringH) [0]); 
TETextBox( textPtr, textLength, &r, teFlushLeft ): 


HUnlock( stringH ); 
} 
else 
{ 
HLock( fDraggedTextHandle ); 


TETextBox( *fDraggedTextHandle, 
(long) GetHandleSize(fDraggedTextHandle) , 
&r, teFlushLeft ); 

HUnlock( fDraggedTextHandle ); 


} 
} 


void 
TTextWindow: :Activate( Boolean activating ) 


if ( activating ) 
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InsertMenu( fgMenu, 0 ); InsetRgn( tempRgn, 1, 1 ); 
gMenuBar->Invalidate(); DiffRgn( dragRegion, tempRgn, dragRegion ); 
} DisposeRgn( tempRgn ); 
else 
DeleteMenu( mText ); err = TrackDrag( dragRef, eventPtr, dragRegion ); 


} DisposeRgn( dragRegion ); 
DisposeDrag( dragRef ); 
void return; 
TTextWindow::Click( EventRecord * ) } 
{ 
this->Select(); 
} 
OSErr 
void TTextWindow: :DragEnterWindow( DragReference dragRef ) 
TTextWindow: :ClickAndDrag( EventRecord *eventPtr ) { 


{ fCanAcceptDrag = IsTextFlavorAvailable( dragRef ); 


OSErr err; fIsWindowHighlighted = false; 
DragReference dragRef; 
RgnHandle dragRegion, tempRgn; if ( fCanAcceptDrag ) 
Rect itemBounds; return noErr; 
char *textPtr; else 
long textLength; return dragNotAcceptedErr; 
Handle stringH; } 
err = NewDrag( &dragRef ); 
if ( err != noErr ) OSErr 
return; TTextWindow: :DragInWindow( DragReference dragRef ) 
{ 
if ( fDraggedTextHandle == nil ) DragAttributes attributes; 
{ 


RgnHandle tempRgn; 
stringH = (Handle)GetString( kDefaultSTRResID ); 


if ( stringy = nil ) GetDragAttributes( dragRef, &attributes ); 
return; 
if ( (! fCanAcceptDrag) || (! (attributes & 
HLock( stringH ); dragHasLeftSenderWindow) ) 
|| (attributes & dragInsideSenderWindow) ) 
textPtr = &((*stringH) [1]); return dragNotAcceptedErr; 


textLength = (long) ((*stringH) [0]); 


if ( this->IsMouseInContentRgn( dragRef ) ) 
err = AddDragItemFlavor( dragRef, { 


(ItemReference) fWindow, if ( ! flsWindowHighlighted ) | 
(FlavorType) 'TEXT', { | 
textPtr, tempRgn = NewRgn(); | 
textLength, RectRgn( tempRgn, &fWindow->portRect ); 


(FlavorFlags)0 ); | 
if ( ShowDragHilite( dragRef, tempRgn, true ) == noErr ) | 
HUnlock( stringH ); fIsWindowHighlighted = true; 
} 
else DisposeRgn(tempRgn) ; 
{ } 
HLock( fDraggedTextHandle ); } 


err = AddDragItemFlavor( dragRef, return noErr; 
(ItemReference) fWindow, } | 
(FlavorType) 'TEXT', 


*fDraggedTextHandle, 
(long) GetHandleSize(fDraggedTextHandle), OSErr 
(FlavorFlags)0 ); TTextWindow: :DragLeaveWindow( DragReference dragRef ) | 
{ | 
HUnlock( fDraggedTextHandle ): if ( flsWindowHighlighted ) | 
} HideDragHilite( dragRef ); 
if ( err != noErr ) 
{ fIsWindowHighlighted = false; | 
DisposeDrag( dragRef ); fCanAcceptDrag = false; | 
return; 


} return noErr: 


itemBounds = (**((WindowPeek) Window) ->contRgn) .rgnBBox: 


err = SetDragItemBounds( dragRef, (ItemReference) fWindow, OSErr 
&itemBounds ); TTextWindow: :HandleDrop( DragReference dragRef ) 
if ( err != noErr ) { 
{ OSErr err; 
DisposeDrag( dragRef ); Size dataSize; 
return; ItemReference item; 


} FlavorFlags flags; 


DragAttributes attributes; 
dragRegion = NewRgn(); 


RectRgn( dragRegion, &itemBounds ); GetDragAttributes( dragRef, &attributes ): 
tempRgn = NewRgn() ; 
CopyRgen( dragRegion, tempRgn ); if ( attributes & dragInsideSenderWindow ) 
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— MacUser Editors Choice Awards, 1993 
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— Dave Winer, Userland Frontier 
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— MacUser review 


“The template that disassembles ‘PICT’s is awesome!” 
~ Bill Steinberg, author of Pyro! and PBTools 
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— Doug McKenna, author of Resorcerer 
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return dragNotAcceptedErr; { 


Point globalMouse; 


err = GetDragItemReferenceNumber( dragRef, 1, &item ); OSErr err; 


if ( err == noErr ) 


err = GetFlavorFlags( dragRef, item, 'TEXT', &flags ); err = GetDragMouse( dragRef, &globalMouse, OL ); 


if ( err == noErr ) if ( err == noErr ) 
{ 


return( PtInRgn( globalMouse, 


err = GetFlavorDataSize( dragRef, item, 'TEXT', &dataSize); ((WindowPeek) fWindow) ->contRgn ) ); 


if (err == noErr ) else 
{ 


return( false ); 
fDraggedTextHandle = TempNewHandle( dataSize, &err );_ } 


if ( fDraggedTextHandle == nil ) 


fDraggedTextHandle = NewHandle( dataSize ); void 


TTextWindow: :SetUpStaticMenu( void ) 
if ( fDraggedTextHandle == nil ) { 


err = dragNotAcceptedErr; 
else } 


TTextWindow::fgMenu = gMenuBar->GetMenuFromCMNU( mText ); 


HLock( fDraggedTextHandle ); 
err = GetFlavorData( dragRef, item, 'TEXT', 
*fDraggedTextHandle, &dataSize, OL ); 


HUnlock( fDraggedTextHandle ); 


SOURCE CODE: TEXTWINDOW.H 


Save and close TextWindow.cp. Create a second source code 


4? ( eee 1 aokrr) window, named TextWindow.h. Here’s the source code: 
( 
err = dragNotAcceptedErr; ifndef _TEXTWINDOW_ 
DisposeHandle( fDraggedTextHandle ); define _TEXTWINDOW_ 
fDraggedTextHandle = nil; 
ifndef | _WINDOW_ 
else #include "Window.h" 
! ; #fendif 
SetPort( fWindow ); 
InvalRect( &(fWindow->portRect) ); aa 
} 
} mIext = L002 
} cFont = 1004, 
} cSize = 1005; 
cStyle = 1006 
return( err ); rs 
} 
class TTextWindow : public TWindow 
void { 
TTextWindow: :SetTextFont( short newFont ) public: 
TTextWindow() ; 
GrafPtr oldPort: virtual ~TTextWindow(); 
GetPort( &oldPort ); virtual WindowPtr MakeNewWindow( WindowPtr behindWindow ); 
SetPort( fWindow ); 
virtual void Draw(void) ; 
TextFont( newFont ); 
virtual void Activate( Boolean activating ); 
SetPort( oldPort ); 
virtual void Click( EventRecord * anEvent ); 
virtual void | ClickAndDrag( EventRecord *eventPtr ); 
Boolean 
TTextWindow: :IsTextFlavorAvailable( DragReference dragRef ) virtual OSErr DragEnterWindow( DragReference dragRef ) ; 
{ virtual OSErr DragInWindow( DragReference dragRef ); 
unsigned short numItems; virtual OSErr DragLeaveWindow( DragReference dragRef ); 
FlavorFlags flags: virtual OSErr HandleDrop( DragReference dragRef ); 
OSErr err; 
ItemReference item; // Non-TWindow methods... 
virtual void SetTextFont( short newFont ); 
CountDragItems( dragRef, &numItems ); virtual Boolean IsTextFlavorAvailable( DragReference dragRef ); 
virtual Boolean IsMouseInContentRgn( DragReference dragRef ); 
if ( numItems < 1 ) static void SetUpStaticMenu( void ); 
return( false ); 
protected: 


err = GetDragItemReferenceNumber( dragRef, 1, &item ); 
if ( err == noErr } 


err = GetFlavorFlags( dragRef, item, 'TEXT', &flags ); 


static MenuHandle fegMenu; 
Static unsigned long fgWindowTitleCount; 


Boolean fCanAcceptDrag; 
return( err == noErr ); Handle fDraggedTextHandle; 
} Boolean fIsWindowHighlighted; 
Ms 
Boolean #fendif 


TTextWindow: :IsMouseInContentRgn( DragReference 


dragRef ) 
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SOME THOUGHTS ON TTEXTWINDOW 


So far, we’ve entered the code for a new class, named 
TTextWindow. As you look through the source code, you'll 
notice that this class bears an incredibly strong resemblence to 
the TPictureWindow class. Exactamundo! There are a few 
changes to the class worth noting. 

First and foremost, we changed the drag flavor that this 
class deals with from ‘PICT’ to ‘TEXT’. This means that a 
TTextWindow supports dragging (in both directions - to and 
from the window) of ‘TEXT’ drag items instead of ‘PICT’ 
drag items. 

As you look through the source code, keep this in mind: 
The default text for the window is a StringHandle loaded 
froma ‘STR ” resource. A StringHand1e is a pointer to 
a pointer to a Pascal string (a length byte, followed by the string 
itself). The data passed around by the Drag Manager is a 
pointer to a block of text, without a leading length byte. The 
length of the text block is passed as a separate parameter. As 
you make your way through the source code, you'll occasionally 
see two cases for dealing with the fDraggedTextHandle 
data member. If fDraggedTextHand1e is nil, we load the 
StringHandle from the ‘STR ”’ resource and are 
therefore dealing with a Pascal string. Otherwise, we already 
have a block of text or are about to receive a block of text, 
neither of which contains a length byte. 

In addition to the changes to get us from ‘PICT’ to 
‘TEXT’, we've added three new member functions to both 
the TTextWindow and TPictureWindow classes. 

Activate() adds that classes’ menu to the menu bar 
on activation, and removes the menu on deactivation. 
TTextWindow::Activate() adds and removes the 
Text menu. TTextWindow: :Activate() adds and 
removes the Picture menu. _ 

Click() gets called when a non-drag click occurs in a 
window’s content region. We call the inherited Select () 
method to bring the window to the front. Without the addition 
of Click(), a click in a non-frontmost window would not 
bring it to the front (clicking in the window’s drag region 
would bring it to the front, however). 

SetUpStaticMenu() is a static member function. It 
calls GetMenuFromCMNU() to load either the Text or 
Picture menu and register all its commands. The loaded menu 
is stored in the static data member fgMenu. Why use static 
members? Static members are not tied to objects of a class, but 
are instantiated once for the entire class. For example, there is 
only one copy of the data member TTextWindow: : fgMenu, 
no matter how many TTextWindow objects have been 
created. All the TTextWindow objects share this single copy 
of fgMenu. The line of code: 


MenuHandle TTextWindow: :fgMenu; 


at the top of TTextWindow.cp actually allocates memory 
for fgMenu before any TTextWindow objects exist. The 
same thing is true for TPictureWindow: :fgMenu. 
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As youll see, we call both — classes’ 
SetUpStaticMenu() functions in the function 
SetupApplication() in the file 
SprocketStarter.cp. This loads the ‘CMNU’ resource 
and registers all the commands before any TTextWindow or 
TPictureWindow objects are created. When one of these 
windows is created, it uses the MenuHandle saved in 
£fgMenu to add the menu to the menu bar without having to 
reregister the commands then unregister the commands each 
time a window is activated and deactivated. 


SOURCE CODE: TPICTUREWINDOW.CP AND 
TPICTUREWINDOW.H 

Here are the rest of the changes you'll need to make to bring 
TPictureWindow up to speed, and to tie in the new menus 
and commands. Edit PictureWindow.cp. and 
PictureWindow.h and add the three new member functions 
and the new static to both files. As a reminder, you'll be adding 
declarations and definitions for Activate(), Click(), the 
static member function SetUpStaticMenu(), and the static 
data member fgMenu. Here’s the code for 
TPictureWindow: :Activate(): 
void 
TPictureWindow: :Activate( Boolean activating ) 
| . ( activating ) 


InsertMenu( fgMenu, 0 ); 
gMenuBar->Invalidate() ; 


else 
DeleteMenu( mPicture );: 


Here’s the code for TPictureWindow: :Click(): 


void 
TPictureWindow: :Click( EventRecord * ) 
{ 


this->Select(); 
} 


Since we don’t use the parameter to Click(), we don't 
give ita name. This keeps us from getting the annoying 
warning about an unused parameter. 

Here’s the code for 
TPictureWindow: :SetUpStaticMenu(): 
void 
(pee nema ee paeardeleat) void ) 


TPictureWindow: :fgMenu = gMenuBar->GetMenuFromCMNU( mPicture ); 
} 


Finally, here’s the line of code you should place at the top 
of PictureWindow.cp. Place it just before or after the 
definition of fgWindowTitleCount: 


MenuHandle TPictureWindow: :fgMenu; 


Here’s the newly updated TPictureWindow.h. Notice 
the enumeration toward the top of the file. Be sure to add this to 
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i € S ¥ than ever before. We know; we feel the same 
way. That’s why Microsoft was one of the first and 
strongest supporters of the Mac, even before it was launched. 
Last year we shipped‘more applications for the Mac than: 


anyone else. We still support the Mac—and you should too. 


Because you love the Mac experience you should also look 


at Windows® 95. Intuitive. user interface, Plug-n-Play hardware, 
long file names...they’re all there in Windows 95. Throw in. 
pre-emptive multitasking, an integrated object model, and 
enterprise connectivity...and you've got a very powerful plat- 
form for creating a whole new generation of insanely teak, i 





: applications. | 


You're wondering how to get involved? We're not talkin’ 
about life in the slow lane here. Register for the 10th Annual 
MacHack today, and learn how your Mac experience will help 
you join your friends | in programming for Windows:95. 





We just shipped a Windows 3.1 version Ray Dream 
signer last October and sales have been excellent, 
rapidly equaling our Mac sales. The market for graphics 
applications on Windows is wide-open. And because of © 
Windows 95's new development tools and features (such 


ming for Windows 95. Come on in; the water's fine! 
Eric Hautemont, President, Ray Dream, Inc. | 
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In response to customer demand, MacHack is once again helping its 
attendees explore their cross-platform development options. This year, 
MacHack is proud to offer you a two-day, pre-conference seminar on 
Windows 95 Programming for Macintosh Developers. A two-day ver- 
sion of the one-day seminars you have heard about at MacWorld. The 
MacHack seminar will go into the depth and detail that the MacHack 
audience demands. You'll be introduced to Windows 95 by the man 
who introduced you to the Macintosh—Stephen Chernicoff, author of 
the seminal Macintosh Revealed series. This seminar will show you 
how to get the most out of: 


The Win32 API ° Virtual Memory Management 
Memory-Mapped Files * Processes and Threads 
Structured Exception Handling 
Windows 95's User Interface Architecture 
Development Tools * Code Portability 


This MacHack seminar won't turn you into a Windows programming 
guru overnight, but it will get you off to a running start. And because 
it's right before MacHack, and in the same location, you can easily 
attend MacHack as well. The seminar will start on the morning of 
Tue. June 20, and end the evening of Wed. June 21—right before 
MacHack kicks off with its keynote address late Wednesday night. 


Windows 95 Seminar: Tues., June 20—Wed., June 21 
$199 if you pre-register before April 16; $249 thereafter 
MacHack ‘95: Thurs., June 22—Sat., June 24 
$375 if you pre-register before April 16; $475 thereafter 
Location: Ramada Inn, Southfield, Michigan (fly into Detroit) 


To register or for more details, 
call Expotech at (313) 882-1824, 

or send email to EXPOTECH on AppleLink or 
expotech@aol.com on Internet. 


Don’t WaitNextEvent—HUnlock the Gestalt of Windows 95 today! 


Copyright © 1994 Microsoft Corporation. All Rights Reserved. Microsoft, Microsoft Press, Windows 95, and Win32 are registered trademarks, and Visual C++ and Windows 
NT are trademarks, of Microsoft Corporation in the United States and other countries. Macintosh and Mac are registered trademarks of Apple Computer, Inc. 











your version. It contains the Picture menu ID and command 


numbers. There a corresponding enum in TTextWindow.h: 


ifndef _PICTUREWINDOW_ 
define _PICTUREWINDOW_ 
ifndef _WINDOW_ 
finclude "Window. h" 
FFendif 
enum 
{ 
mPicture = 1001, 
cCentered = 1002, 
cUpperLeft = 1003 


ie 


class TPictureWindow 
{ 


public: 


: public TWindow 


TPictureWindow(); 
virtual ~TPictureWindow();: 


virtual WindowPtr MakeNewWindow( WindowPtr behindWindow 3 


’ 


virtual void Draw(void): 





virtual void Activate( Boolean activating ); 





virtual void Click( EventRecord * anEvent ); 


’ 


virtual void ClickAndDrag( EventRecord *eventPtr ); 


’ 


virtual OSErr 
virtual OSErr 
virtual OSErr 
virtual OSErr 


DragEnterWindow( DragReference dragRef ); 
DragInWindow( DragReference dragRef ); 


DragLeaveWindow( DragReference dragRef ); 
HandleDrop( DragReference dragRef ); 


’ 











// Non-TWindow methods... 

virtual PicHandle LoadDefaultPicture(); 

virtual void CenterPict( PicHandle picture, 
Rect *destRectPtr ); 
virtual Boolean IsPictFlavorAvailable( DragReference dragRef ); 
virtual Boolean IsMouseInContentRgn( DragReference dragRef ); 
static void SetUpStaticMenu( void ); 





protected: ; 
feMenu; 


Static MenuHandle 
static unsigned long fgWindowTitleCount; 
Boolean fCanAcceptDrag; 
PicHandle fDraggedPicHandle; 
Boolean fIsWindowHighlighted; 

is 

#fendif 


SOURCE CODE: SPROCKETSTARTER.H 


Next, add this enum to SprocketStarter.h. It contains 
the command numbers we added to the File menu: 


enum 

f 

l 
cNewTextWindow = 1000, 
cNewPictureWindow = 1001 


i 


SOURCE CODE: SPROCKETSTARTER.CP 
Next, edit the file SprocketStarter.cp. In the routine 


SetupApplication(), add these two lines just before the 
callto InitCursor(): 
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TTextWindow: :SetUpStaticMenu() ; 
TPictureWindow: :SetUpStaticMenu(); 


Here’s the new’ version of the routine 


HandleMenuCommand (), with our new command number 


constants. Notice that we lost the command cNew: 


void 
HandleMenuCommand (MenuCommandID theCommand) 
{ 
switch (theCommand) 
{ 
case cAbout: 
AboutBox():; 
break; 


case cNewTextWindow: 
CreateNewTextWindow(); 
break; 


case cNewPictureWindow: 
CreateNewPictureWindow(); 
break; 


case cCentered: 
SysBeep( 20 ); 
break; 


case cUpperLeft: 
SysBeep( 20 ); 
break; 


case cOpen: 
OpenExistingDocument (); 
break; 


case cPreferences: 
TPreferencesDialogWindow * prefsDialog = 


new TPreferencesDialogWindow; 
break; | 


if qAOCEAware 
case cNewMailableWindow: 


TMailableDocWindow *aWackyThing = new TMailableDocWindow: 
break; 
ifendif 


default: 
break; 
} 
} 


We'll add the command handling code in next month’s 
column. For now, we are only concerned that the proper 
menu appears when the appropriate window is in front and 
that the text dragging code works. 

Next, add these two function prototypes to the file: 


OSErr CreateNewTextWindow(void) ; 
OSErr CreateNewPictureWindow(void) ; 


Add these’ two 
setupApplication(): 


routines after the routine 


OSErr 
CreateNewPictureWindow(void) 


TPictureWindow *aNewWindow = new TPictureWindow(); 


if (aNewWindow) 
return noErr; 

else 
return memFullErr; 


} 
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From: MindVision (Creators of Stacker for Macintosh) 
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OSErr 


CreateNewTextWindow(void) 


{ 


TTextWindow*aNewWindow = new TTextWindow(): 


if (aNewWindow) 
return noErr; 
else 


return memFullErr;: 


\ 
J 


Here’s a new version of CreateNewDocument (). 
Notice that instead of creating a TPictureWindow object in 
line, we call one of the object creation routines we just created: 
OSErr 
CreateNewDocument (void) 


{ 


return CreateNewTextWindow():; 
} 
J 


Finally, add the ##include for TextWindow.h at the 
top of the file: 


#include "TextWindow.h" 


RUNNING THE PROGRAM 


You've just made a bunch of changes to your source code, so 
chances are, you'll probably have a few kinks to iron out 
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before you get your code to compile. As always, if you run 
into problems, send email to sprocket@hax.com and we'll try to 
help. Of course, if you don’t feel like typing in all these 
changes, you can find the source code at all the usual on-line 
places. Just remember, if you are downloading the project, be 
sure you end up with the folders “SprocketPicText.03/25/95” 
and “Sprocket.02/01/95”. The files I uploaded were named 
“SprocketPicText.03/25/95.sit” and “Sprocket.02/01/95.sit”. 

OK. When you run your project, a text window will 
appear, along with a Text menu. Don’t bother with the Text 
menu yet. We'll fill all that in next month. For now, open the 
Scrapbook, then click back on the text window to bring it back 
to the front. Click and drag from the text window to the 
Scrapbook. The text <Default Text> should appear in 
the Scrapbook. Find some text and paste it into the Scrapbook. 
Drag the text from the Scrapbook into the text window. Love 
that Drag Manager! 

Next, create a new picture window. Notice that the Text 
menu disappears and that a Picture menu appears. Once 
again, don’t bother with the Picture menu items. We'll get to 
them next month as well. Click on the text window to bring 
the Text menu back. 

A correction from a few month’s ago. Faithful reader Joe 
Kaufman wrote in to point out that in the ListTester application, 
we never delete the link in the routine DeleteLink(). 
That is a problem! Add the line 


delete linkPtr; 


just before the return at the bottom of 
TLinkedList::DeleteLink(). Thanks for the eagle- 
eyes, Joe. 


"Tm NExT MONTH 

Hmmm... This column ran a lot longer than I anticipated. Sorry 
about that. It’s just that once you start playing with Sprocket, 
it’s hard to stop. Next month, we'll add the font-oriented 
submenus to our Text menu and use them to change the font, 
size, and style of the text displayed in each window. We'll also 
implement the commands listed in the Picture window. Until 
then, take a look through the source, especially at the static 
data members and member functions. 





To receive information on any products 
advertised in this issue, 


send your request via Internet: 
productinfo@xplain.com 
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Tablelt! Features: 


¢ Unlimited number of rows and columns - go 
past the typical 32K limitation! 

¢ Support for core, database, table and text 
suites. Playable, Recordable and Attachable. 

¢ Over 100 properties that provide customized 
look and feel. 

¢ Drag and Drop Support. 

¢ In-cell editing 

¢ DR/2 for OpenDoc available now! 


Pricing: 
$150 retail for stand-alone, HyperCard, 


SuperCard or 4D. Developers Licenses and 
OpenDoc part licenses available. No Royalties! 


Graphical Business Interfaces, Inc. 
Voice: 219-253-8623 Fax: 219-253-7158 
E-Mail: info@gbi.com 
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Information 


he Debugger is a low and high-level symbolic 
Debugger that runs in a full multi-window 
Macintosh environment. You can trace program exe- 


cution, view the values of variables, etc. of both 68K and 


PowerPC programs. 

MacNosy is a global interactive disassembler that 
enables one to recover the source code of any Mac applica- 
tion, resource file or the ROM. 

When you compare features of the different debuggers, 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program in a full system (6.0x or System 7.x) environ- 
ment symbolically! 

It is the only debugger to use the MMU to protect your 
CODE resources and the rest of the system from the pro- 
gram you are debugging. With MMU Protection you can find 
errors when they happen, not millions of instructions later! 
(Macintoshs with 68030 CPUs only). 

The Debugger is the debugger of choice at: Adobe, 
Aldus, Claris, Electronic Arts, Kodak, Metrowerks, etc. 
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Its Features Include: 


© Symbolic Debugging of any Macintosh program, ROM, or 
code resource (DRVRs, XCMDs, INITs, PDEFs, 4DEXs ..) 


® Source level debugging for Metrowerks & MPW compiled 
programs (C++, C, Pascal, Fortran, ...), and an Incremental 
Build System with instant Link for superfast development. 


© Object Inspector for MacApp 3 programs 
® Source level debugging of Think C™ projects 


® Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc. 


® Simultaneous Symbolic debugging of multiple “tasks” 


® Fast Software Watchpoint command to find clobbered 
variables 


® Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Handle Zapping, Heap 
Scramble and Heap Check to detect program errors before 
they become disasters 


® Structured display of data (hypertext) with user definable 
structures while debugging 


® Conditional breakpoints to help filter out redundant 
information 


® Continuous Animated Step Mode to watch your program 
execute instruction by instruction 


® Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps, - 
make it possible to ferret out the secrets of the ROM, etc. 


® "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 


The Debugger V2 & MacNosy: $350 


Runs on all Macs. Call For Group prices or Updates. 
Visa/MC Accepted. 


Available from: Jasik, APDA, Frameworks or 
ComputerWare (800-326-0092). 


Jasik Designs + 343 Trenton Way, Menlo Park, California 94025 + (415) 322-1386 


Internet: macnosy@jasik.com ¢ Applelink: D1037 
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CLIENT/ 


SERVER 
DATABASES 





By Liam Breck, Northampton, MA 





An Introduction to Client/Server Database 
Development 


A review of the 
technologies behind a 


revolution 





WHAT’S THE BUZZ? 


Client/Server Computing is one of the 
industry's hot buzzwords today, but just 
those two words alone don’t provide 
enough context for a specific discussion. 
Client/server is a very general software 
architecture that can be applied to a vast 
range of software missions. But if you 
overhear business execs talking about 
client/server, chances are you'll hear 
about SQL servers in the same 
conversation. What are they really 
talking about? The mundane world of 
corporate database management. Only 
it isn’t so mundane anymore... 

A great wave of change is swelling at 
the very heart of the computer industry 
where big iron has held sway and users 
have been stuck in front of mouseless, 
monochrome terminals. Mini-computers 
and even Unix workstations are 
encroaching on mainframe turf, while 
personal computers with a GUI are 
replacing the terminals. What’s driving this 
trend are client/server database (hereafter 


CSDB) systems based on a common query _ 





language and standardized communications protocols, which allow 
unprecedented diversity in large information systems. 

In this, and articles that will hopefully follow in future 
issues, I'll be discussing the software components of CSDB 
systems, with a close eye on the development tools used in this 
field. This month I offer a general overview of the field, 
without discussing product specifics. If you are eager for 
specifics, examine the references at the end of the article, which 
points to places where they can be found. (Let us know what 
you think of these types of CSDB articles too! — Ed. nst] 

First, a quick clarification about the people referred to 
herein. “Vendor” refers to a company which develops and 
publishes a particular software tool. “Developer” refers to a 
user of that tool (you!). “User” refers to a user of an application 
created by that developer (probably using that tool). 


Basic ELEMENTS 
A CSDB system consists of three primary software components 
(aside from the network software and operating systems of the 
computers in question): the client application (also called the 
front end), the data access layer (also called middleware), and 
the database server (also called a database engine, DBMS, data 
source, or back end). 

The client application is responsible for accepting input 
from the user, submitting a guery to the database server based 
on that input, receiving results from the server, formatting them, 
and presenting them to the user, 

The data access layer is relatively transparent to the user, 
but may be very apparent to the developer of the client app. It 
provides for the app an API used to submit queries to a data 
source without much concern for the network between them. 

The database server accepts queries from clients, processes 
them concurrently, and returns results. There are a number of 





Liam Breck — Liam Breck is the Chief Investigative Officer at Data Innovations, a consultancy in Amherst, Mass., and the 
Special Projects Moderator for the Info-Mac Network (whose headquarters is distributed). He is a Macintosh database 
developer and the author of several electronically published documents about client/server database systems. He welcomes 
comments and questions, and can be reached at breck@external.umass.edu. | 
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The Interface Designer and 
Application Builder 


FaceSpan™ v2 is an extensible Rapid Application 
Designer (RAD) that makes building applications quick 
and easy. It combines an interactive, visual interface 
design environment with the object-oriented power 
of AppleScript or any OSA language. Best of all, 
FaceSpan allows you to integrate the capability of 
scriptable programs into your custom application. 
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different query languages around, by far the most prevalent of 
which is SQL. (By the way, contrary to conventional wisdom, 
“SQL” doesn’t stand for anything in particular. The ‘S’ isn’t for 
“standard” or “structured,” although the ‘QL’ is thought to stand 
for “query language.”) 


STRENGTHS AND WEAKNESSES 
Before we get into detail about these primary components, let’s 
discuss some of the advantages and weaknesses of these 
systems. There’s a lot of hype about “moving to client/server,” 
“downsizing,” “upsizing,” “rightsizing,” etc. It needs to be put 
in perspective. Older systems, by the way, are often referred to 
as “legacy,” “centralized,” or “host-based.” 

A lot of the expected advantages of these systems are in 
their hardware requirements. CSDB systems distribute 
processing between the client, which runs the user interface 
and certain application logic, and the server, which handles the 
database engine and centralized data access logic. In an ideal 
scenario, this division of labor can prevent the slowdowns 
associated with systems where all the processing is performed 
centrally. However, this distribution creates a new potential 
bottleneck — the network. The network is also vulnerable to 
overloading by use external to the database application. 

Another hardware benefit is the ability of an organization to 
employ cheap standard computers for both clients and servers, 
rather than one vendor’s proprietary hardware. Such machines 
are also general purpose — they can be sent on other missions and 
moved around the organization. On the other hand, so-called 
standard computers are often difficult to integrate. Centralized 
systems can be more turnkey in this respect. 

In both hardware and software aspects, CSDB systems are 
billed as being scalable and modular. This is true to the extent 
that the designers plan for it. It is possible to develop CSDB 
systems which can evolve smoothly and incrementally into large 
services and whose components are replaceable with new 
products. It is discouragingly easy, however, to develop a 
CSDB system whose user capacity and/or transaction capability 
has a low ceiling, or whose components are tied to one 
another. But with careful planning, a CSDB system can be 
better in both respects than a host-based design. Keep in mind 
that diversity, which often follows effective modularity, can 
make for a significant management headache, especially where 
software deployment is concerned. 

A major advantage claimed by CSDB proponents is the 
quality of development tools in this market. It is undeniable 
that major advances have been made in development tools in 
the last few years, and CSDB tools have made the most 
advances of any. Procedural 4GLs, object-oriented 4GLs, 
graphical GUI builders, object-oriented GUI builders, even 
graphical object-oriented “languages,” data modelers, 
component repositories... The list of features to boost 
programmer productivity is quite long. 

Reduced development time is the expected gain from all 
this tool evolution, and this is the area of CSDBs I’ve seen 
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hyped the most. “Develop a full working CSDB application in 
an hour without writing a single line of code!” Don’t believe a 
word of it. As development tools have improved, expectations 
of applications have risen doubly so. While it’s true that you 
probably won’t spend as much time poring over SQL source, 
and may not ever have to write a line of C, you will have to 
exploit all your development environment’s functionality, and 
this may mean writing a substantial amount of (OO)4GL code. 
In fact, the environment often won’t do something you need, or 
won't do it fast enough, and you will be forced to write an 
external procedure in C or another 3GL. 

Just as in every other area of software development, it is 
easy and common to seriously underestimate the time required 
to turn out the application as spec’ed, and it is highly unlikely 
that someone important will not insist on a change in the spec 
during the implementation phase! Be pessimistic when drawing 
up the schedule. 

There is a major potential software disadvantage, too. Let's 
face it, modern personal computer software — including 
operating systems, system extensions, development tools, and 
commercial and custom applications — is just not that stable. 
Hardly ever is a commercial product fully debugged before its 
next major version is released and the vendor ceases to support 
the previous one. Feature fever is bad for software stability, 
and almost never is “bug-free” regarded as an important feature 
by vendors. Mission critical systems simply cannot depend on 
such software. It wasn’t always this way. I’ve heard stories 
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about older computer systems that have actually never crashed 
at most of their installations! 

The advantages of CSDB systems are leading many 
organizations to consider migrating to them. Migrating a user 
base of any size from a host-based database to a CSDB system 
really requires re-engineering the business processes underlying 
the software of the legacy system. Business processes are 
usually developed with the computers of their day in mind. 
Re-implementing an existing business process in a new 
environment may not provide any of the expected benefits if 
that process is especially well adapted to a legacy system, or if 
it is fundamentally inefficient. Business Process Re-engineering 
is a whole field unto itself, and is outside the scope of 
MacTech, let alone this article. I can only caution the reader 
that software design is not the first, nor the most difficult, issue 
in migration. 


Ess-CuE-ELLE SPELLED OUT 

The proliferation of SQL as the lingua franca of database systems 
has pushed the trend towards diverse, distributed data systems, 
despite the current (and hopefully temporary) lack of full 
interoperability of SQL-based products. The view here is focused 
solely on SQL-based tools, but there is not a single feature set for 
all SQL-accessible servers, nor one for all SQL-capable clients. 

SQL is more of a language family than a single language. 
Although there is an evolving standard for it, many vendors have 
made proprietary extensions to the 1989 standard, in some cases 
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creating incompatibilities with the 1992 standard. SQL is a non- 
procedural language, though some implementations have been 
extended to include procedural and even object-oriented 
features. Procedural functionality in CSDB development is 
usually only provided by the language used to build client apps. 
Let's examine a typical SQL query on a database that has a 
table for clients (client) and a table for the clients’ 
appointments (appnt). 
SELECT client.name, client.city, appnt.date, appnt.time 
FROM client, appnt 
WHERE client.idnum = appnt.idnum 
AND appnt.date > :twoWeeksAgo 


AND appnt.date <= :today 
ORDER BY appnt.date, appnt.time; 


This query performs four basic operations: 

¢ joining the client and appnt tables such that each 
appointment is matched to a client with the same ID 
number (specified by the FROM clause and the first 
comparison of the WHERE clause) 

¢ selecting rows in the joined table whose date lies in a 
certain range 

* sorting the rows by the date and time of the appointment 

e selecting columns (listed after SELECT) from the joined table 
to display 
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The SELECT, INSERT, UPDATE, and DELETE statements 
make up the core of SQL’s data manipulation language (DML). 
SQL has a data definition language (DDL) that allows 
developers and admins to control a database’s schema or data 
structure. Its core statements are CREATE, ALTER, and DROP. 
SQL also has a powerful construct called a view, which is 
defined by a SELECT statement, and is used like a table in DML 
statements. It can provide a layer of abstraction from tables, 
which generally represent the decomposition of the data model 
necessary for the database engine. 

SQL's cursor construct is a feature heavily used by client 
applications, because it provides them with controlled access to 
query results. A cursor is also defined by a SELECT statement, 
and allows its creator to step through (and in some cases move 
around in) the results with the FETCH statement. Rows in a 
cursor can be modified by UPDATE and DELETE statements. 

There is, of course, much more to SQL than I can 
summarize here. The best way to learn it is hands-on with the 
particular database server with which you will be developing 
applications, since SQL varies a lot among its implementations. 

By the way, I avoid use of the word “relational” when 
describing database functionality. There are two reasons. One: 
It goes without saying that SQL-accessible database servers are 
relational by the common use of the term (which seems to 
mean: “rows in one table can own or belong to those in another” 
— a fairly dumb definition). Two: NO such database servers are 
literally relational because none implement the Relational Model 
published by E. F. Codd. Indeed, critics of SQL assert that SQL is 
an obstacle to realization of the Relational Model. 


TOOLS OF THE TRADE 
There are many different types of software tools used in the 
development of CSDB systems. Here are the major categories: 


¢ Client builders enable the development of custom client 
applications. 

¢ Database programming tools enable the development of 
server-side application elements. 

¢ CASE and data modeling tools assist with the design and 
implementation of the database itself. , 

¢ Database administration tools aid in the administration and 
maintenance of the database and the server responsible for it. 


This month we study the features of client builders, the most 
glamorous tool category. We'll study the other categories in 
future issues. 


THE MAJOR FEATURES OF CLIENT BUILDERS ARE: 
Support for development on and deployment to the major 
OS platforms 

Cross-development is not all it’s cracked up to be. Chances 
are, if a vendor has ported only their runtime module (and not 
the development environment) to a platform, then they don't 
really understand or appreciate that platform. It is sadly the 
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case that many client builders supporting development on the 
Macintosh originated on other platforms, and sometimes don’t 
support the Macintosh as well as they should. 


Transparent access to various data sources 

Most client builders can access most of the popular 
database servers, such as Oracle, Sybase, and Informix, plus 
ODBC-accessible servers. Some client builders can be extended 
by the developer to access additional data sources. To enable a 
client application to hit different back end targets without extra 
work by the developer, client builders usually provide a standard 
way to access the general capabilities of different servers. This 
can take the form of an SQL-like language, a proprietary query 
language, or a graphical query builder. 


A graphical GUI builder with special objects for data 
presentation 

To the standard collection of GUI objects, client builders’ 
WYSIWYG screen painters add special objects that support the 
presentation and manipulation of database rows without extra 
coding. Most GUI builders can be extended (with the help of a 
3GL compiler) to include new kinds of objects. Some also have 
object-oriented features that assist in the development and 
maintenance of new GUI objects and collections thereof. In 
cases where the client application is compiled (as opposed to 
interpreted), client builders may include a way to examine and 
test the results of your GUI development efforts before runtime. 


A programming language with a full-featured library 
The language is probably the most important component of 

a client builder, and the current market is divided into four 

broad language categories: 

¢ CSDB-focused products: These tools generally feature a 
fairly sophisticated 4GL, often with OO features. 

¢ Standard-language-based toolkits: These may be complete, 
vendor-integrated toolkits for CSDB development, or a 
developer’s collection of favorite tools from different vendors. 
Smalltalk and C++ are the dominant languages in this category. 

e Graphical language products: These tools are based on non- . 
textual languages in which programming is accomplished by 
linking together pictures representing available services. 

¢ Desktop database products with extensions for SQL-capability: 
These tools usually have a relatively limited, procedural 4GL. 


Most important is the language library’s feature set. It must 
be able handle GUI control, file management, communications, 
data access and manipulation, reporting... all of the functionality 
that’s provided to a 3GL by the OS and standard libraries, and 
then some. This is a tall order, and vendors’ standard libraries 


— don’t usually fill it completely. Fortunately, in many cases, library 


extensions are available from third parties, or may be grown at 
home by the developer in a 3GL or the tool's native tongue. 
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A runtime engine 


This consists of the library of standard functions called by 
the developer’s code (usually the whole thing, not just the 
functions actually called), and possibly an interpreter for the 
client builder’s language. In some cases an interpreter is the 
only way to run the client app; in other cases the app may be 
compiled. The runtime engine may be a separate file on disk, 
or reside in the client app. 


A debugger 

OO4GL or not, client builder languages can embody logical 
errors, and even flaws that will crash the app and possibly the 
computer. A toolset’s high level debugger may not work at all 
in the latter case, but it will let you set a breakpoint and step to 
the innocent line of code that has somehow managed to trigger 
a serious bug in the client builder itself. 


SOME CLIENT BUILDERS ALSO INCLUDE THESE FEATURES: 
A database modeling/definition tool 

These vary widely among client builders, but few approach 
the quality of dedicated data modeling tools. Some client 
builders have built-in support for third party modeling tools. 


An SQL database engine for development use 

This is usually a single-user engine, though some client 
builders provide a complete CSDB toolkit out of the box by 
including a full-fledged multi-user server. 


A graphical query builder 

The quality of query builders also varies a lot among client 
builders. They sometimes require more effort than simply 
typing the corresponding SQL, but they often save much 
tedious coding. 


A graphical report writer 

Very few environments omit reporting capabilities entirely, 
but not many have full-featured report builders. These tend to 
work in much the same way that GUI builders do, though they 
cannot be entirely WYSIWYG because their layouts are created to 
print variable amounts of information. Language libraries usually 
have a group of functions that work with the report builder. 


Support for development teams 

As the popularity of CSDB systems has increased, so has 
the number of developers stumbling over each others code on a 
given project. Not only must source code text be managed, but 
also GUI elements, data structures, and evolving libraries of 
these pieces. Some client builders can use the services of a 
third party version control system. 


A compiler which generates native code, pseudo-code, or 
3GL code 

To get the developer’s efforts up to speed on user 
workstations, a vendor has three options: a native compiler for 
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their language for each target platform, a pseudo-code compiler 
whose platform-independent output is pseudo-interpreted by a 
runtime engine, or a translator that generates 3GL code for the 
target platform. I feel that the presence one of these is crucial. 
Several client builders only provide interpreters, making their 
runtime engines large, and apps sluggish. 


A reasonable memory footprint for compiled apps 

;-) If you think C++ and an app framework make for 
oversize applications, you’re in for a nasty surprise when you 
start writing apps with just about any of the client builders on 
the market. User workstations typically need to dedicate three 
or more megabytes of memory to an app written with one of 
these tools. Brace yourself. 


A business rule modeling system 

Business rule development is a complex area. Basically, a 
business rule system centralizes general rules about data 
manipulation and integrity, and obviates the need to implement 
them in the GUI code, on a case-by-case basis in the client app, 
or in server procedures. In the finished application, the rules 
will actually dwell in those locations, but that is transparent to 
the developer. Very few client builders have a sophisticated BR 
system, though emphasis on the need for this feature is 
increasing. 


Distribution of application components across a network 

Following on the evolution of BR systems is the emergence 
of development tools that can transparently distribute parts of 
your application to appropriate computers in your network and 
link them together into an integrated, but distributed, 
computing system. This is the province of very high end tools, 
and is a fairly new segment of the CSDB market. 


No runtime/distribution fees 

A fair number of vendors impose a per-user. charge for 
distribution. Unlike the concurrent-user charges assessed by 
database server vendors, these runtime fees apply to every 
workstation where the client application is deployed, active or 
not. This often involves copy protection which can prevent 
legal use of the app. There is only one thing to say about such 
practices: “Grrrrrrr!” 


MAKING ENDS MEET 


A data access layer provides an API that lets you submit SQL 
statements from clients on different platforms to (possibly 
diverse) data servers, and handles the network protocols and 
(in some cases) the server differences behind the scenes. It 
provides a function library which can be called from 3GL (and 
often 4GL) environments, and often requires intermediate server 
software that resides on the server host and passes client 
requests to the database engine. The implementation of the 
library for a particular client platform, network and data server 
is usually called a driver, and a client needs a driver for each 
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data source it accesses. 

There are two types of data access APIs, server-specific 
native systems from server vendors (Sybase Open Client, 
Oracle OCI/SQL*Net, Informix Net, etc.), and server-general 
middleware systems from third parties. Native systems are 
tuned for their target servers, do not require intermediate server 
software, and generally perform better than middleware 
systems. Middleware systems are useful where the API is not 
transparent (i.e., in a 3GL) and there are diverse servers, or 
when a native solution is not available for a required data 
source. (Non-relational database systems, in which 85% of all 
corporate data is said to be housed, often do not have native 
APIs.) Transparent support for different data access APIs, 
especially native ones, exists in most of the client builders on 
the market. Thus, most developers will not have to learn a 
data access API in order to get started. 

I will take up specific data access layers in another issue, 
but two bear brief mention here due to their status on the 
Macintosh. 

DAL (originally CL/1), from Independence Technologies 
and an Apple product until recently, has been around for a 
while, and is the most prevalent middleware system currently 
employed on Macintosh clients. It adds some useful extensions 
to SQL which enable offloading of some data processing from 
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client to server. However, its performance may be limited in 
some environments. It accesses the popular database servers 
on a variety of host platforms. It is used in concert with the 
Data Access Manager API of the MacOS and also supports 
Microsoft Windows clients. 

ODBC is a Microsoft implementation of the SQL Access 
Group Call-Level Interface specification, and Apple has ported it 
to the Macintosh. It does not require intermediate server 
software. ODBC driver development is the province of server 
vendors and third parties, and the current availability of 
Macintosh drivers is limited and growing slowly. ODBC drivers 
are usually implemented as translators for a native API, which 
may result in poor performance. ODBC is criticized for its 
three-level specification which means different drivers may not 
support the same functions. Microsoft is beginning to downplay 
ODBC in favor of new data access capabilities in OLE. 


BEHIND IT ALL 
Database servers are the workhorses in a CSDB system. They 
consist of two integrated components, an SQL parser and a native 
database management system. The server translates and 
optimizes SQL queries for the native DBMS, performs the queries, 
and returns the results to clients. Data servers generally need 
significant horsepower in the host computer and multitasking 
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capability in the host operating system in order to process queries 
from concurrent users in a reasonable time frame. 

Due to these requirements the servers currently available 
for the MacOS are mostly meant for light-duty multi-user or 
single-user applications. The PowerMacs based on the new 
PowerPC Reference Platform specification, running PowerOpen 
(Apple’s and IBM’s new Unix), Netware, Windows NT, or a 
future MacOS, have the potential to attract more server vendors 
to Apple hardware. Reference Platform PowerMacs are still a 
year away, however, and versions of these operating systems 
for them are necessarily farther off. 

We'll have a closer look at SQL database servers in general, 
and those for the Macintosh in particular, in the near future. 


GETTING STARTED 

If you are not involved in developing a CSDB project for your 
employer, but want to get your feet wet with SOL and a client 
builder tool and/or a data access API, where do you start? 
Mac ODBC with an ODBC driver for a single-user database 
engine or even a text-based data source, and an inexpensive 
client builder (perhaps the 3GL compiler you probably 
already have) might be the best place. The SQL specified by 
ODBC is pretty standard, most client builder tools can access 
data sources through ODBC, and its API is similar enough to 
others to be generally educational. Be aware, however that 
some drivers may not include much documentation about 
SQL or ODBC’s dialect thereof. (Note that as of this writing, 
it might be difficult to assemble this toolset, but I expect the 
technical and availability issues to be ironed out by the time 
the article appears.) 


CSDB INFORMATION RESOURCES 
Here is a collection of resources (one of which I developed) 
that many have found valuable in keeping up to date with 
CSDB technology for the Macintosh. 

The Macintosh Client/Server Database Development 
Summary is an overview that covers over 30 software tools for 
Macintosh and cross-platform development in three categories: 
client application development tools, data access layers, and 
database servers. The eight page document provides an 
explanation of each category and a brief description of each 
product. It can be obtained through the WWW at 
http://www.astro.nwu.edu/lentz/mac/software/csdb-summary.html 
(best method), or by emailing a request including your name, 
position, department and. organization to 
maccsdb@external.umass.edu. 

DBMS magazine, published by Miller Freeman, is a good 
source for product reviews and industry trends, though it 
doesn’t usually have much to say about the Macintosh. For an 
evaluation copy contact MF Circulation at (800) 227-4675. 

The Center for the Application of Information Technology 
maintains an extensive collection of pointers to IT resources at 
http://www.cait.wustl.edu/cait/infosys.html. 

The Usenet newsgroup comp.client-server has moderate 
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Tools Plus 2.5 


Tools Plus gives you the routines you need 
to create a professional looking user interface. 
Then we make it work. It’s that simple. 
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picture buttons, scroll bars, menus (pull-down, hierarchical and pop-up), 
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Significantly less debugging e Safer than toolbox routines 
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Draginstall makes your installer choice easy 





cS Easy for your users 


To find out just how easy 
DragInstall is, call us at 
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Ray Sauers Associates, Inc. 
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Clifton, NJ 07011-2252 USA 
Voice: 201-478-1970 

Fax: 201-478-1513 
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Compuserve: 70731,2326 
Internet: sauers@aol.com 












traffic and is consistently interesting. The Macintosh database 
newsgroup comp.sys.mac.databases is not such a good 
source of CSDB info, but if you’re posting a question about 
CSDBs for Macintoshes, I suggest you cross-post to both 
groups. The comp.databases.[vendor] groups are more 
heavily trafficked, and some of them are contributed to by 
the vendor’s technical support staff. 

Trade shows are usually a good source of hype and 
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confusion, but may also offer opportunities to talk to 
knowledgeable vendor personnel. -The Database and 
Client/Server World show will be held during June 13-15 in 
Boston. The show Expo is free. Hint: don’t just wander 
around the expo floor, study the program and try to hit all the 
vendors that interest you. For info contact DCI at (508) 470- 
3880 or dbworld@aol.com. 2 
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By Jeremy Roschelle 


Add an advanced feature 
to this popular framework 


One of System 7’s most advanced 
features is its support for system-level 
scripting via AppleEvents. The 
AppleScript programming language can 
give users the ability to automate tasks, 
customize the interface, and connect 
independent applications to perform a 
task. Although Apple has presented 
these capabilities as advantages to 
business users, they are an powerful 
addition to educational software — what 
Icreate. In my present project, 
“SimCalc,” we decided to add scripting 
to give students, teachers and 
curriculum authors the ability to set up 
mathematical simulations. 
Unfortunately, AppleEvents sports 
System 7’s least comprehensible 
documentation. Although AppleEvents 
sounded attractive, dense writing in 
Inside Mac VI sent me running for cover. 
With the arrival of better documentation 
and direct support for the AppleEvents 
Object Model (AEOM) in the PowerPlant 
class library, I decided to come out from 
hiding. After learning many lessons the 
hard way, SimCalc is now fully scriptable. 
This article brings together many 








Powering Up AppleEvents in PowerPlant 


bits of necessary information that I discovered along the way. It 
will guide you through the process of using PowerPlant to 
make your application “scriptable” — able to respond to 
AppleEvent commands written in AppleScript or other scripting 
systems. However, no attempt is made to fully explain the 
AppleEvent Object Model or the concept of a “recordable” 
application. For that information, see Inside Mac: 
InterApplication Communication. AppleEvents and AppleScript 
are powerful capabilities, and by inheriting the basics from 
PowerPlant classes, you can easily give your users the power to 
write scripts that manipulate your application’s objects. 


PIECES OF THE PUZZLE 
One of the difficulties in getting started with AppleEvents is 
making several components work smoothly with each other. 
Here is an overview: 

The AppleEvent Object Model (AEOM) defines a generic 
view of a scriptable application. Every application presents 
itself to AppleScript as a containment hierarchy. For example, 
in our SimCalc application, the application contains documents, 
documents contain pages, and pages contain graphs. Each 
object in the hierarchy has properties that the user can get and 
set. Events operate over the objects in the hierarchy, creating 
and deleting them, and changing their properties. 

An application’s “terminology resource” (resource type 
‘aete’) presents the application’s AEOM interface to other 
applications and scripts. It describes your application’s 
containment hierarchy, along with the actions possible on 
objects in the hierarchy. The ‘aete’ resource also translates 
between the English-like AppleScript vocabulary and four- 
character descriptors that your application can easily respond 
to. There are descriptors for classes, properties, and event 
names and parameters. 





Jeremy Roschelle — Jeremy Roschelle works for the University of Massachusetts, at the, umm, “San Francisco campus.” From 
his spacious, bedroom-like, corner office, he is developing software to help students learn “the mathematics of change” with 
interactive graphs and animated characters. Crossing “Doom” with Calculus provides a positive outlet for responding to 
traumatic memories of past mathematics teachers. And because his Ph.D. is in education, there’s hardly anything else he’s 
qualified to do. Contact jeremy at jeremy@dewey.soe.berkeley.edu. 
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PowerPlant provides several support classes to handle 
AppleEvent interaction. The central class is LModelObject, 
which handles properties, events, and containment relations for 
one class in the containment hierarchy. By deriving your 
classes from LModelObject, handling AppleEvents becomes 
a relatively simple matter of overriding appropriate methods. 

ScriptEditor, which is part of the AppleScript kit and 
included with System 7.5, is helpful for testing your work. It 
provides tools for reading an applications ‘aete’ terminology 
dictionary, writing and checking the syntax of scripts against the 
terminology resource, and compiling and executing the script. 


AEOM CONVENTIONS AND TERMS 

Awareness of a few conventions and terms will make reading 
this article easier. The AppleEvent Object Model uses the 
standard separation of an application into verbs and nouns. 
Each verb is an “Event” and each noun is a “Class.” For 
example, the statement “Close Window 1” consists of the “close” 
event applied to the first object in the “window” class. Events 
have a “direct object,” which, by convention, is the noun to 
which the verb is applied (e.g., the window). Events take a list 
of keyword-specified parameters and can return a value. 

A class corresponds to one level in the containment 
hierarchy. In our application, we have a class for the 
application, document, page, and graph level, among many 
others. An AEOM class need not correspond to a C++ 
implementation class; in particular, you don’t need an AEOM 
class for every C++ class, just those that will be direct objects of 
the Events you implement. A class has “Properties” to 
represent its state. For example, for example a page includes a 
name and index number as properties. The containment 
hierarchy is organized by the “Elements” relationship: in our 
application, the elements of the application class are 
documents, the elements of the document class are pages, and 
the elements of the page class are graphs. 

PowerPlant uses the “L” prefix to distinguish library classes 
and we use “SC” to distinguish SimCalc classes. 


ORGANIZATION OF THE ARTICLE 
This article divides the task of making your application 
scriptable into five parts: 
adding a new class to the model hierarchy 
adding a property to the class 
adding a generic undo facility that supports every property. 
adding an event handler for a standard event 
adding a custom event 


oR ON 


Each of these processes will require changes to the C++ 
classes derived from the PowerPlant class library, as well as 
changes to the terminology resource. Each change will be 
tested using ScriptEditor. Organizing the effort by processes 
makes it easier to see how AEOM, the terminology resource, 
PowerPlant, and Script Editor interrelate. 
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ADDING A NEw CLASS 


In PowerPlant, LApplication, LDocument, and LWindow 
inherit from LModelObject, which provides the root of the 
containment hierarchy. The terminology resource that comes 
with PowerPlant already specifies the “Elements” relationship 
among these classes, as well as the properties of each class. 

In our SimCalc project, our documents are notebooks 
consisting of a list of pages. We want to support our notion of 
a page in the AEOM containment hierarchy. This requires 
changes in both the terminology resource and the SimCalc C++ 
classes. Specifically, we add the Page class to the terminology 
resource in two places, define appropriate methods for our 
SCPage class, and override some LModelObject methods 
in the containing class, SCDoc. 

A good place to start making your application scriptable is 
with the terminology resource. Resorcerer provides a very 
good editor for the ‘aete’ resource. We start with the ‘aete’ 
supplied with PowerPlant, which describes the application, 
windows, and documents. To this we add information about 
the existence of the page class, and use the Elements 
relationship to indicate that documents contain pages. 

Information in the terminology resource is organized into 
suites, with standard suites defined in the AppleEvents Registry, 
and custom suites defined elsewhere. Since pages are specific 
to our application, we create a new suite called the SimCalc 
suite. The name of the suite and its description are arbitrary, 
but your users will see them when they read your ‘aete’ 
resource with ScriptEditor’s “Open Dictionary” command. The 
suite id should be unique (registering it with Apple will 
maintain uniqueness). 
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Figure 1: Adding the Page Class to the SimCalc Suite 


Adding class to the containment hierarchy involves two 
operations — creating the class and specifying which container 
has elements of this type. We'll add our class to the SimCalc 
suite. To do this in Resorcerer, position the cursor within the 
classes box and press the New button. The class name you 
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provide will be used by AppleScript to name the class in 
English, so choose a short noun. I find it helpful to capitalize 
the first letter of all English names for debugging: ScriptEditor’s 
syntax editor will replace statements with the capitalization you 
provide. Therefore if you type statements into ScriptEditor in 
lowercase, you can tell if ScriptEditor is recognizing your 
names by the capitalization. 

The class id you choose will be used to identify objects of 
this class inside your application, and therefore must be unique 
within your ‘aete’. The description of the class is not 
functionally important, but will be read by users as they try to 
understand what the class represents. 

In our application documents contain pages. In the 
terminology resource, the “Elements” relationship is indicated in 
the containing class. To specify that pages are elements of 
documents, we edit the definition of the document class, adding 
the class id of the page class to its elements field. In addition to 
adding the element, you must specify how the element can be 
accessed from the container. The most common ways to access 
a document are by name and index, and our pages also have 
unique ids, so we added that to the list. 

Incidentally, Resorcerer doesn’t know about the ‘ID ’ form 
code; you have to type it in by hand. Also “absolute position” 
is a bit misleading, since PowerPlant can use this information to 
compute a variety of relative references as well. References to 
the first, last, middle element, as well as reference to an object 
before or after another object are computed from an absolute 
position reference. 
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Figure 2: Specifying that a page is an element in the document 
Now we have completed editing the containment 


hierarchy. To check our work, we can open the terminology 
resource from ScriptEditor’s Open Dictionary command. 
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Page by numeric index, by name, by ID 
Properties: 
name string [1/0] -- che dle of the document 
modified boolean [rio] -- Hes the document? been modified since the last save? 
selection reference -- the selected page 


Figure 3: ScriptEditor shows that pages have been added to 
documents 


ScriptEditor parses the information provided, and presents 
it in readable form. Because we created a class with the name 
“Page” and made it an element of documents, ScriptEditor can 
check the syntax of scripts that refer to pages with a variety of 
reference forms: 


tell application "PoweringUp" 
get Page 1 -- by absolute position 
get last Page -- uses absolute position 
get Page "first" -- by name 
get Page after Page "first" -- 
get Page id 10 -- by id 

end tell 


by relative position 


Now its time to make the application recognize these 
references. Fortunately, PowerPlant makes this fairly easy. Each 
object only needs to know about its “SuperModel” (i.e., the 
container in which it resides) and any submodels it contains. The 
SuperModel-SubModel relationship is the same as the “Elements” 
containment relationship. The containment relationship is 
different from the Class-SubClass inheritance relationship; AEOM 
has no good way to express inheritance relationships . 

In the SimCalc example, a page needs to know its 
containing document (its SuperModel), and the document needs 
to be able to locate pages as SubModels. In addition, the class 
must override GetModelKind, which is used by PowerPlant to 
generate an external description of an object. Returning ‘page’ 
will let PowerPlant know that this particular object is a page. 

The external description should be the same as the class id 
defined in the terminology resource. In our case, the class 
definition looks like this: | 





class SCPage : public LModelObject { SCPage.h 
public: 
enum { modelKind = 'page'} 


SCPage(SCDoc *inDoc); 
virtual ~SCPage(); 
virtual DescType GetModelKind() const; 


The constructor sets up the object’s SuperModel. The 
SuperModel is the object that contains this class in the 
containment hierarchy. 





SCPage:SCPage(SCDoc *inDoc) : LModelObject() SCPage::SCPage 
{ 


mSuperModel = inDoc; 
inDoc->AddSubModel (this) ; //stores the page in the Doc's list 
} 
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SCPage::~SCPage 
SCPage:~SCPage(SCDoc *inDoc) 8 


{ 
mSuperModel - >RemoveSubModel (this) 
mSuperModel = nil; —// prevents removal by LModelObject 


: LModelObject () 


The GetModelKind member function overrides the 
default, and returns the class id. 





SCPage::GetModelKind 
DescType 


SCPage::GetModelKind() const 
{ 
return SCPage::modelKind; 


In the SimCalc document class we store each page in a 
mPageList member variable, which is an LList. To 
maintain this list, we override the 
LModelObject::AddSubModel method, which gets 
called by the SCPage constructor. Now we have ensured that 
pages refer to the document as its SuperModel, and the 
document refers to pages as its elements. 





~ SCDoc::AddSubModel 
SCDoc: :AddSubModel (LModelObject *inSubModel) 
{ 
if (SCPage::modelKind == inSubModel->GetModelKind()) { 
mPageList.InsertItemsAt(1,arrayIndex_Last, &inSubModel) : 
} 
} 





SCDoc::RemoveSubModel 
void 


SCDoc: :RemoveSubModel (LModelObject *inSubModel) 
( 
if (SCPage::modelKind == inSubModel->GetModelKind()) { 
mPageList.Remove(inSubModel) ; 
} 
} 


While these methods are simple, a subtle C++ gotcha is 
carefully avoided. In the SCPage constructor, we could have 
set up the SuperModel-SubModel relationship by passing 
inDoc in the LModelObject initializer, ie., 


SCPage:SCPage(SCDoc *inDoc) : LModelObject(inDoc) 
{ 


If we did this, the dynamic type check in 
SCDoc::AddSubModel would return the wrong value. It 
turns out that GetModelKind would return typeNul1l 
instead of scPage. Why? 

AddSubModel is called within the LModelObject 
constructor, and when this constructor is called, the SCPage 
vtable is not yet constructed, and the object is just an 
LModelObject. When the SCEleDoc method asks for its 
type, LModelObject: :GetModelKind is called, instead 
of SCPage: :GetModelKind. Gotcha! 

The same problem occurs upon deletion. When the 
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LModelObject destructor is called, the vtable has already 
been deconstructed from an SCPage to a LModelObject, 
so GetModelKind returns typeNull again. (So in our 
destructor, we manually break the super-sub model 
relationship instead.) 

We could also try adding items to the LList without 
checking their type, but this turns out to be a problem, too: 
PowerPlant will call AddSubModel whenever a property is 
constructed for an object, so any properties of the document will 
end up inside mPageList with the pages — not a good thing. 

Once we have the super-sub model relationship set up, we 
use it to enable AppleEvents to find pages within the container 
hierarchy. The document class must be able to count and 
locate its elements. The CountSubModels method is used 
to calculate references that use the “middle” and “last” forms. 





SCDoc::CountSubModels 
Imes 2 


SCDoc: :CountSubModels(DescType inModelID) const 

{ 
if (inModelID = SCPage::modelKind) return mPageList.GetCount(): 
ThrowOSErr_(errAENotAnElement) ; 
return 0; // prevent compiler warning 


PowerPlant catches exceptions within its AppleEvent 
handlers and returns an error code, so whenever an operation 
can’t be completed its best to throw an error. 

Next we must take care of an omission in 
LModelObject. Even though LModelObject defines 
the CountSubModels method, it doesn’t use it to respond 
to a CountElements AppleEvent. So we can’t ask for the 
“number of pages” in AppleScript. Fortunately, its simple to 
remedy this by overriding HandleAppleEvent to call 
CountSubModels: 





SCDoc::HandleAppleEvent 


void 
SCDoc: :HandleAppleEvent ( 
const AppleEvent G&inAppleEvent, 


AppleEvent &outAEReply, 
AEDesc &outResult, 
Int32 inAENumber) 


{ 
switch (inAENumber) { 
case ae_CountElements: 
// note: we should extract the desired kind 
// rather than assuming its SCPage::modelKind 
Int32 count = CountSubModels(SCPage::modelKind); 
OSErr err = AECreateDesc( typeLongInteger, 
(Ptr) &count, 
sizeof(long), S&outResult) ; 
FailOSErr (err); 
break; 
default: 
inherited: :HandleAppleEvent (inAppleEvent, outAEReply, 
outResult) ; 


since SimCalc defined absolute position, name, and id 
forms in the terminology resource we need to override the parallel 
LModelObject member functions for our document type. 
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The most common way to find an element is by position. 
For example, in AppleScript you can say: 


page 1 of application "PoweringUp" 
last page of application "PoweringUp" 


When PowerPlant receives an AppleEvent with a position- 
based object specifier, it calls the containing LModelObject’s 
GetSubModelByPosition member function. This 
member function locates the element at the desired location, 
and returns a “token” containing that element. PowerPlant 
supplies and manages an appropriate class of tokens, so we 
don’t need to worry about the details of token implementation. 





id SCDoc:: GetSubModelByPosition 
vo 
SCDoc: :GetSubModelByPosition ( 
DescType inModellID, 
intoaz inPosition, 
AEDesc &outToken) const 
if (inModelID == SCPage: :modelKind) { 
SCPage *page; 
if (mPageList->FetchAItemt (inPosition, &page)) { 
PutInToken (page, outToken) ; 
return; 
} 
ThrowOSErr_(errAENotAnElement) ; 


The second most common way to refer to an element is by 
name, as in: 


page “perfect” of document 1 
Overriding the LModelObject: :GetSubModelByName 


member function will handle this. In the method below, pages are 
found by iterating through the mPageList that contains them. 





SCDoc::GetSubModelByName 


void 

SCDoc: :GetSubModelByName ( 
DescType inModellID, 
str255 inName, 
AEDesc &outToken) const 


{ . 
if (inModelID == SCPage: :modelKind) { 
SCPage *page; 
Str255 pageName; 
LListIterator iter (mPageList,iterate FromStart) ; 


while (iter.Next(&page)) { 
page->GetDescriptor (pageName) ; 
if (EqualString(pageName,inName,false,false)) { 
Put InToken (page, outToken) ; 
return; 
} 
} 
ThrowOSErr_(errAENotAnElement) ; 


When referring to an element by unique ID, AEOM allows 
any type of data be to used as the unique ID (unlike the index 
and name cases, which use a long and a text string, 
respectively). Therefore PowerPlant provides the actual 
descriptor record rather than providing a number or a string as 
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in the prior cases. This adds the extra step of extracting the 
unique ID from the descriptor record. This is best done using 
the static methods of the UExtractFromAEDesce class, 
thereby performing any necessary coercions. 





SCDoc::GetSubModelByUniqueID 


void 

SCDoc::GetSubModelByUniqueID ( 
DescType inModellID, 
const AEDesc &inKeyData, 
AEDesc &outToken) const 


{ 
long id,pagelID; 


UExtractFromAEDesc: :TheInt32(inKeyData, id) ; 


if (inModelID == SCPage: :modelKind) { 
SCPage *page; 
LListIterator iter (mPageList,iterate FromStart) ; 


while (iter.Next(&page)) { 
pageID = page->GetID(); 
if (pageID == id) { 
PutInToken (page, outToken) ; 
return; 


| 
J 


} 
} 
ThrowOSErr_(errAENotAnElement);: 
} 


Finally, we have to override the 
GetPositionOfSubModel method, which is used to 
compute relative references (i.e., page after page 3). 





SCDoc::GetPositionOfSubModel 
Int32 


SCDoc: :GetPositionOfSubModel ( 
DescType inModellID, 
const LModelObject *inSubModel) const 


if (inModelID == SCPage::modelKind) { 
return mPageList.FetchIndex0Of (&inSubModel) ; 
} 


ThrowOSErr_(errAENotAnElement) ; 
return 0; // prevent compiler warning 


In our actual SimCalc application, the containment 
hierarchy has additional levels: Pages contain graphs, for 
example. Because the implementation of the page-graph 
Elements relationship is exactly the same as the document- 
page, we'll skip the details. The important thing to notice is 
that no matter how deeply nested the AppleScript container 
Syntax gets, you only need to implement the Elements 
relationship between each class and its immediate SuperModel. 
PowerPlant and AEOM do the rest for you. 

At this point, we have a working containment hierarchy for 
pages. However, because the page class has no properties, and 
responds to no events, the demo is pretty dull. We'll fix that in the 
next two sections, first adding properties, and then event handling. 


ADDING PROPERTIES TO THE CLASS 
In the AEOM, a property is a state variable of an object in the 
container hierarchy. Scripts change the state of the application 
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by changing properties of objects. An application describes its 
classes’ properties in the terminology resource. Inside, the 
application handles properties via the PowerPlant 
LModelProperty class property. To add a property to a 
class, you have to edit the terminology resource and override 
two LModelObject methods. 

The resource template has a slot for a list of properties 
within each class. For the page in SimCalc, we defined 
properties for the name, index, and id of each page. The name 
can be set by the user, but the index and id are read-only. The 
string you provide for the property name is used to refer to the 
property in AppleScript, and will be translated to the value in 
the code field when received by your application. The class 
field is the type of the variable. AppleScript will coerce user- 
supplied input into this type. The AppleEvent Registry defines 
many standard property names and types. You should use the 
most appropriate type. 

A couple of warnings are due: be careful not to re-use an 
existing property code with a different property name (i.e., 
giving the ‘pnam’ property the name “descriptor” instead of 
“name”). This will mostly likely confuse AppleScript. Also, I’ve 
found that AppleScript sometimes caches an applications ‘aete’ 
resource. After you edit an ‘aete’, you may need to restart your 
Macintosh to get AppleScript to notice the changes. 





Index integer [ro] -- the page number 
name string -- name of this page . 
Id integer [ro] -- the unique id of this page 


Figure 4: ScriptEditor shows the properties of the Page Class 


Implementing properties in an object derived from 
LModelObject is easy — you just override SetAEProperty 
and GetAEProperty. Explaining how it works is a bit more 
difficult, because PowerPlant does a lot of work behind the 
scenes to make properties easy to support. After presenting the 
two overridden functions, I’ll explain the gist of how it works. 

GetAEProperty dispatches on the property id, and 
places the value of the desired property into a AppleEvent 
descriptor record. The property ids for pIndex and pName are 
defined in AERegistry.h, and our header file defines 
pUID to be ‘ID ’. Its no accident that these identities are the 
Same as those that appear in terminology resource. 
AppleScript uses the terminology resource to translate English 
names for properties. 
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Figure 5: Adding properties to the terminology resource 





SCPage::GetAEProperty 


void 

SCPage: :GetAEProperty ( 
DescType inProperty, 
const AEDesc &inRequestedType, 
AEDesc &outPropertyDesc) const 


{ 
long id, index; 
Str255 name; 


switch (inProperty) { 
case pIndex: 
index = GetIndex(); 
Fail0SErr_(AECreateDesc(typeLongInteger, (Ptr) &index, 
sizeof(long), &outPropertyDesc)); 
break; 
case pUID: 
id = GetID(); 
FailOSErr_(AECreateDesc(typeLongInteger, (Ptr) &id, 
sizeof(long), &outPropertyDesc)) ; 
break; 
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case pName: 
GetDescriptor (name) ; 
FailOSErr_(AECreateDesc(typeChar, &(name[1]), 
name[0], &outPropertyDesc)); 
break; 


Setting a property is very similar to getting a property; the 
main difference is that instead of putting a value into a a 
descriptor record, you take one out. This can be done directly 
by calls to the AppleEvent manager, or through PowerPlant. 
There is a big advantage to using PowerPlant’s methods: they 
will coerce data into the right type for you, and throw an 
exception if coercion fails. This exception will be trapped 
within PowerPlant’s basic AppleEvent handlers, so the 
exception will be transparent to you. But PowerPlant will give 
the user an appropriate error message. PowerPlant defines 
extraction methods in UExtractFromAEDesc via a 
pseudo-template mechanism that makes it easy for you to add 
extraction methods for any additional types you need. 





SCPage::SetAEProperty 


void 

SCPage: :SetAEProperty ( 
DescType inProperty, 
const AEDesc &inValue, 
AEDesc &outAEReply) 


{ 
Str255 name; 


switch (inProperty) { 
case pName: 
UExtractFromAEDesc: :ThePString (inValue,name) ; 
CopyPStr(name,mName) ; 
break; 
default: 


inherited: :SetAEProperty(inProperty,inValue,outAEReply) ; 
} 


} 


As you can see, adding properties to an LModelObject 
is not hard. You can test that the property works in 
ScriptEditor. Some example lines are: 
tell application “PoweringUp” 

copy name of page 1 to oldName 

copy oldName & “er” to newName 

set name of page 1 to newName 


get index of page newName 
end tell 


Here’s the story on how this works. AppleScript sets and 
gets properties by applying the standard set data and get data 
events to property tokens. Consider the execution of the line: 


copy name of page 1 to oldName 


PowerPlant handles properties by re-using standard 
AppleEvent handling. The routine for handling any AppleEvent 
is to first get a token representing the object (the noun), and 
then send it the event (the verb). Rather than defining a 
second token type for properties, PowerPlant treats properties 
as a class of LModelObject. During the execution of an 
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AppleEvent that refers to a property, PowerPlant creates an 
LModelProperty on the fly, destroying it at the end of 
event processing. This LModelProperty has the target 
object as its SuperModel and has an mPropertyID member 
variable to represent the identity of the property. When the 
property receives a set or get data event, it calls its 
SuperModel’s SetAEProperty and GetAEProperty 
methods, specifying its property id. 


SUPPORTING UNDO FOR ALL PROPERTIES 
Supporting AppleEvents seems to be a lot of work for most 
simple tasks. But it actually can make my most dreaded task, 
supporting Undo, easier. 

Think about it: Most of the application’s changes to state 
are changes to the value of properties. There is a standard 
form for naming these properties, the property id, and standard 
methods for getting and setting them. The only problem is that 
the property data may come in a variety of forms, and we need 
to be able to store them all — an anathema to C++ strong 
typing. This is where AppleEvents shines by providing a 
dynamically typed descriptor record that can store any sort of 
property value. 

In SimCalc, we support property undo with a subclass 
of LModelProperty. When handling an incoming set 
property event, this subclass calls GetAEProperty just 
before it calls SetAEProperty. It stores the previous value 
and a duplicate of the new value in a task, along with the 
target LModelObject and the id of the property. Using 
these entities, the task can easily respond to undo and redo. 
As a finishing touch we parse the ‘aete’ resource for the English 
name of the property and incorporate this into the undo menu 
item in the edit menu. This provides totally automatic handling 
of undo for property values we might ever define, without any 
additional work. 

Our special form of property overrides only one method, 
to post a SCSetPropertyAction whenever the user tries 
to set the value of a property. 





oid SCModelProperty::HandleSetData 

Vv 

SCModelProperty: :HandleSetData ( 
const AppleEvent &inAppleEvent, 
AppleEvent &outAEReply) 

{ 

SCApp::PostAction(new SCSetPropertyAction(GetSuperModel (), 
mPropertylD, 
inAppleEvent) ); 


The interesting work is done in _ the 
SCSetPropertyAction, which is derived from 
LSemanticAction. The constructor gets the old value, 
and saves it along with the copy of the new value, in member 
variables mNewData and mOldData. These member 
variables are StAEDescriptors; they hold AppleEvent 
descriptor records, and automatically dispose of those 
descriptors when upon destruction. 
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SCSetPropertyAction::SCSetPropertyAction 


SCSetPropertyAction: :SCSetPropertyAction ( 
LModelObject *inObject, 
DescType LHP ropi, 
const AppleEvent G&inAE) 
LSemanticAction(200,3), mObject(inObject), mPropID(inPropID) 


// get old data from object itself 

StAEDescriptor reply; 

mObject->GetAEProperty(mPropID, reply.mDesc, mOldData.mDesc); 
mNewData.GetParamDesc(inAE, keyAEData, typeWildCard) ; 


UAppleEventsMgr: :CheckForMissedParams(inAE) ; 


Now the redo and undo methods are nearly trivial, and 
work regardless of the C type that stores the property value: 





SCSetP Action::RedoSelf 
void etPropertyAction::RedoSe 


SCSetPropertyAction: :RedoSelf() 
{ , 


StAEDescriptor result; // will dispose result on deletion 
mObject->SetAEProperty(mPropID,mNewData.mDesc,result.mDesc) ; 
} 





wha SCSetPropertyAction::UndoSelf 
Vv 

SCSetPropertyAction: :UndoSelf () 
{ 


StAEDescriptor result;// will dispose result on deletion 
mObject->SetAEProperty(mPropID,mOldData.mDesc,result.mDesc): 
} 


The final step is to force our object to use 
SCModelProperty instead of LModelProperty by 
overriding GetModelProperty. 





S ::GetModelP 
LModelProperty* CPage::GetModelProperty 


SCPage::GetModelProperty(DescType inProperty) 
{ 

return new SCModelProperty(inProperty, this) ; 
} 


ADDING EVENT HANDLING FOR A STANDARD EVENT 


According to the AEOM, you should represent most of your 
application’s state as properties of classes. Many user 
commands therefore translate into setting a property. Some 
commands, however, are best thought of as verbs that operate 
on a noun, changing the state of the application in a way that 
cannot be reflected in a single property. In this case, you 
probably need to define and handle an event. 

Consider the act of changing pages. When the user clicks 
the “next page” or “previous page” button, the application 
changes the entire contents of the screen. I think of this most 
naturally as sending the document a change page event, with 
the name or number of the desired page as a parameter. 
However, AEOM has its own way of thinking about things; and 
Apple discourages users from inventing events where a 
standard one will do. In this case, changing a page can also be 
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represented by sending the page a “select” event. In 
AppleScript you type: | 


tell application "PoweringUP" 
select page 43 
end tell 


At first, this convention of using sending “select” to a page 
rather than “change page” to a document seems arbitrary. But 
it turns out to have important implications. Apple’s preferred 
methods factor the verb from the designation of the noun, 
whereas the “change page” method incorporates the noun as a 
parameter of the verb. The practical difference is that the 
“select” method can operate over an arbitrary expression that 
designates a page object, such as: 
select (page after page 4) 
select (page before page id 104) 


select last page 
select (make new page at end) 


The standard terminology resource supplied with 
PowerPlant already contains the select event. Therefore to add 
event handling for select, we need only modify code internal to 
the application. In particular, we should override the 
LModelObject method that handles AppleEvents, which 
strangely enough is called HandleAppleEvent. 





vena SCPage::HandleAppleEvent 
SCPage: :HandleAppleEvent ( 
const AppleEvent é&inAppleEvent, 


AppleEvent &outAEReply, 
AEDesc &outResult, 
Int32 inAENumber) 


{ 
switch (inAENumber) { 
case ae Select: 
((SCDoc *)GetSuperModel())->SetSelection(this); 


break; 
default: 
inherited: :HandleAppleEvent( inAppleEvent, 
outAEReply, 
outResult, 
inAENumber) ; 
break; 


Handling an event with no parameters is just a matter of 
dispatching on the AppleEvent number. SimCalc_ internally 
prefers to treat changing the page as a responsibility of the 
document, so we call the ChangePage method of the page’s 
SuperModel1, (which will be its document; we set it up that 
way in the constructor). 

There is one subtle mystery with the parameters to this 
function. Can you find it? In the terminology resource, an 
event is identified by its class id and its event id, but here an 
event is identified by a number which has no correspondence 
to either of those ids. The translation between these two forms 
of event identity was initially a deep mystery to me. 

It turns out that the mapping is represented in an ‘aedt’ 
resource. There is one ‘aedt’ for each suite, and each item in 


MACTECHMAGAZINE ® JUNE 1995 


the ‘aedt’ contains a suite id, an event id, and a long integer. 
PowerPlant uses this resource to translate incoming events ids 
to a long integer, which is then passed to your object’s 
HandleAppleEvent method. It is also important to 
understand that the class id for an event is not the id of a class! 
Rather “class id” in this context means a class of events 
contained in a suite. For example the class id for standard 
events like close is ‘core’ and appears in the ‘coRe’ suite. 


DEFINING NEW EVENTS 
The previous example covered handling an event already 
defined within the terminology resource. Adding a completely 
new event is possible, and combines parts of the processes 
described in preceding sections. In short, to add an event you: 


1. add the event to an appropriate suite of the terminology 
resource 

2. add a mapping from suite and event id to a number in an 
‘aedt’ resource 

3. add a case to the switch statement in HandleAppleEvent 
that: 
a. extracts descriptor records for each parameter in the 

event 

b. extracts C++ values from the descriptor records 
c. calls a member function that does the work 
d. creates a descriptor record containing any return value 


To illustrate, we will add a “sort” event to the document, 
allowing it to sort the pages into alphabetical order. 

First, we need to edit the terminology resource, adding the 
new event to the PoweringUp suite. We'll use ‘P Up’, our 
application’s signature, as the class id, and ‘sort’ as the event id. 
These two bits of information also need to be added to an 
‘aedt’ resource along with a unique long integer that will signify 
this event within the application. The event name supplies the 
English verb that will create this event from within AppleScript, 
but the description is purely informational. The reply type for 
our event is a null, since we don’t return anything. 

The direct object comes right after the verb in AppleScript 
syntax; it is the first parameter of the event. If the direct object 
has object specifier as its type, PowerPlant will call that object 
with the HandleAppleEvent message. You can think of 
this translating to C++ syntax as: 


(direct object) ->EventName(parameterl,parameter2,.... i 


The direct object for the sort command will be the document. 

In this case we want one additional parameter which 
describes the sort direction. We could use a Boolean to represent 
the sort order, but to make things nicer, let's use an enumeration. 
Then the user can type “ascending” or “descending” rather than 
remember which direction “true” implies. 

To indicate that this will be an enumerated parameter, we 
turn on that option and use the id of the enumeration, which 
we will define as ‘Esrt’. Then in the enumeration section of the 
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suite, we create an enumeration of this type, and specify each 
option as an enumerator. Each enumerator has a name that 
can be typed in AppleScript, and a corresponding id code that 
will be sent in the event. 


preeeneente Syite events By enc ianiinti (iim chun aMGitc Ime atN 
- Event name “sort” 
Description “sorts the pages alphabetically ” 
Align 
Event class code = ‘P Up’ 
Event ID ‘sort’ 
[¥) Reply type None=‘null’ 
Reply description 
15. Reply is optional Off 
14. Reply must be list of Items Off 
13. Enumerated Off 
1-12. Reserved 0 
0. Mon-verb event Off 
[¥) Direct parameter preferred type Object specifier="obj ° 
Direct parameter comment = “send to the document” 
15. Direct parameter is optional Off 
14. Direct parameter is list of items Off 
13. Enumerated Off 
12. Changes state Off 
O-11. Reserved O 
Parameters | 


poseneneanen Parameters 8] cccccccccscreceeeeeseeeeseenneessneennsseensrannascennsnsensseennnnsensecnninersanennnes 
: Parameter name “in direction” 
Keyword ‘srtD’ 
Type = ‘Esrt’ 
Description “direction of the sort” 
15. Parameter is optional On 
i4. Parameter must be a list of Items Off 
13. Enumerated On 
3-12. Reserved 0 
2. Feminine Off 
1. Masculine Off 
0. Plural Off 
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Figure 6: The terminology for the Sort event 


esseensenn Ermurmeratioms S| cccccccceccccrcecceererseeeeeeeeeneseeseesennnneeenenennaenceennn 
Enumeration code ‘Esrt’ 

Enumerators 2 

reise Enumerators Fy hlevGraAsh eden aan biakesiads spbisdextaewoctuind 

: Enumerator name “ascending” 

Enumerator ID ‘> ° 

- Description “ascending alphabetical order “ 
inne Enumerators #5 FsVRINAHRLE RIPE snARae ae aeaaee 
: Enumerator name = “descending” 

Enumerator ID ‘< ’ 

Description “descending alphabetical order ” 


Figure 7: The terminology for the sort direction enumeration. 


To finish off the parameter description we need to provide 
a parameter name and keyword. The name will become part 
of the AppleScript syntax of the event. Since we specified “in 
direction” as the name, we will be able to say: 


sort in direction ascending 
sort in direction descending 
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pages al ¥ 
sort reference -- send to the document 
[in direction ascending/descending] -- direction of the sort 


Figure &: ScriptEditor shows the terminology for the Sort event. 


i aedt 131 “ owering up” from PoweringU ) 
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em or. preter 
Event class ‘PF Up’ 
Event ID ‘sort’ 
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Figure 9: The aedt resource maps class and id to a number 


Inside the application, the work if fairly easy. We will 
retrieve the parameter with the ‘srtD’ keyword. To 
SCDoc:HandleAppleEvent, we add a case statement that 
triggers on the long integer we set in the ‘aedt’ resource, 10000. 





SCDoc::HandleAppleEvent 
void 
SCDoc: :HandleAppleEvent ( 

const AppleEvent &inAppleEvent, 


AppleEvent &outAEReply, 
AEDesc &outResult, 
Int32 inAENumber) 


{ 
switch (inAENumber) { 
case ae_CountElements: 
HandleCountEvent (inAppleEvent, outAEReply, outResult); 
break; 
case ae Sort: 
{ 


StAEDescriptor desc; 
OSType direction = kSortAscending; 
desc.GetOptionalParamDesc( inAppleEvent, 
keySortDirection, 
typeEnumeration) ; 
if (desc.mDesc.dataHandle != nil) { //check for parameter 
UExtractFromAEDesc: :TheEnum(desc.mDesc,direction) ; 


} 


DoSort (direction == kSortAscending) ; 
break; 
} 
default: 
inherited: :HandleAppleEvent( inAppleEvent, 
outAEReply, 
outResult, 
inAENumber) ; 
break; 


In the this routine’s sort case, we first get the descriptor for 
the sort parameter. PowerPlant provides a handy routine for 
this: GetOptionalParamDesc. Since this parameter is 
optional, it may not exist. If it does exist, the dataHandle 
of the descriptor will not be nil. Then we can use 
UExtractFromAEDesc::TheEnum to extract the enum 
from the descriptor. Then we dispatch to our member function 
that does the work. 
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is a collection of five menu defini- 
tion resources (MDEFs) that you just 
paste into your project's resource file. 


Build a menu using the MDEF and * 
then just handle menu selections like any 
normal menu. 









tngable 
Enable 





Also contains Maitre d’, a special menu develoment tool 
that assists you in designing your MENU MILL Menus. 


WUMILL 


‘Use your drawing programs as programming tools 
- Fast unobtrusive RGB color picker 
- Space saving Geneva 9 MDEF 
- Calander Menu 
Call (601) 255-6713 


wst.aD 69 e 9 5 
FAX (601) 255-7086 


DEVELOPED BY STAZ SOFTWARE, INC 





Write, Ariel Publishing, Inc. 
11A Leisure Time Drive, 
Diamondhead, MS 39525 





CONCLUSION 


Good AppleEvent support is the distinguishing mark of a 
System 7-savvy application. By building on the classes 
provided within PowerPlant, supporting AppleEvents becomes 
a simple, incremental process. 

First, you characterize your application as an AEOM 
containment hierarchy, consisting of classes linked by the 
Elements relationship. This is accomplished by specifying the 
classes and the Elements relationship in the terminology resource, 
deriving your class from LModelObject, and overriding a few 
key methods. Second, you add support for setting and getting the 
value of the properties of your classes. This is achieved by editing 
the ‘aete’ to specify English property names and corresponding 
internal property ids. Then you override the GetAEProperty 
and SetAEProperty methods appropriately. Third, you add 
support for additional events that your class responds to. Again 
this requires editing the ‘aete’, as well as the ‘aedt’. Then you add 
a clause to your objects’ HandleAppleEvent method. 

As an natural extension to this methodology, you could 
handle Create, Delete, and Move events for any object in your 
hierarchy. An abstraction that builds on LList can support 
these events uniformly for any container in your hierarchy, 
including general Undo handling. By supporting Create, Delete 
and Move, along with the events already supported within 
PowerPlant, you will be well on your way to handling the 
whole AppleEvents Core Suite. 
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By Rich Parker, Modesto, CA 





Symantec C++ v8.0 is Here! 





New Native Power Mac & Symantec C++ v8.0 product also includes a complete 68K 
development environment and associated compilers, source 

68K D evelop ment level debugger, and other tools. However, the remainder of this 

Environments article focuses on the native Power Macintosh tools. 


“” Modeless 


THE NEW, NATIVE SYMANTEC C++ (2) Project Files 


fas Project Resources .rsre 


The new Symantec v8.0 product is a 
complete, native Power Macintosh and Tehran WadeesG be 
68K development suite. While 68K vinual pr cninsee este 
development still uses the THINK Project b (“) Runtime Libraries 
Manager (TPM) development = [“) Source 

environment, the environment for native | CApp.cp 

Power Macintosh development is 
completely new and improved. The 
Symantec Project Manager (SPM) has 
been completely rewritten for the Power 
Macintosh. It supports multiple, nested 
projects, gets rid of the ugly segmentation 
issues that prevail in 68K development 
environments, and provides very fast 
compilation and linking. The new SPM 
provides a full set of options that allow 
you to specify the settings for building 
suites of applications, with multiple, Figure 1. The Project Manager Window 
nested projects, as well as static or shared 
libraries. The two environments (SPM 
and TPM) share the same source libraries 


CMain.cp 
CSaver_CMain.cpp 
CSettings .cp 
main.cp 
References .cp 

xC App .cp 
xCMain.cp 


oO ¢ 6 ¢ ¢ G¢ 2 O © 
i ua) un) ni un) ui ui) uni 
& ¢ ¢ ¢ ¢ ¢ @ ¢ 


x_CSettings .cp 
(_] THINK Class Library 
(_] Apple Event Classes 





v 
> 


THE NEW PROJECT WINDOW 


and TCL. The project window for the new Power Macintosh development 
In addition to the new native Power environment is shown in Figure 1. This illustrates a view that 
Macintosh development tools, the includes individual folders in which the various sets of source 





Rich Parker — Rich Parker is a book author and software developer. He spends his days (and nights) writing programming 
books for both the Macintosh and Windows platforms. His latest obsession is called Mastering the THINK Class Library for 
Addison Wesley, which is all about the TCL, Visual Architect, and Symantec C++ products. He expects the book to be 
available in time for the August MacWorld Expo bash. When not writing and programming, he spends his time flying his F/A- 
18 Hornet into harms way and is looking forward to the release of the A-10 flight simulator. If you would like to write to 
Rich, asking a question or correcting a mistake, please feel free to do so. Rich can be reached on CompuServe at 76556,1132 
or on the Internet at rparker@moa.com. 
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files are listed. When you create a new project, the SPM places 
the relevant files for the type of project you’ve chosen into 
various folders. The figure shows part of the organization for a 
TCL project. 

Each of the folders has a control that when clicked toggles 
the list of files (or other folders) it contains from being shown 
or hidden. Being able to hide all of the extraneous files is a big 
help, particularly when you're developing an application that 
contains many of its own files. Folders can be nested to any 
depth, so you can group your own source files into various 
categories and then open only the ones whose contents you 
wish to see at any particular moment. For example, the entire 
THINK Class Library is held in a folder with nested folders for 
the various categories of source files. 

In addition to organizing files within folders, the SPM 
includes “Project Window” options that show whether 
individual files need to be recompiled, as indicated in Figure 1. 
The diamond indicator at the left of each file name is filled in 
when a file needs to be recompiled. The SPM is very 
intelligent about tracking dependencies. If you change a 
header file that various other files depend upon, then all of the 
affected files will have filled diamonds next to their names. 

The right side of the project window, immediately to the 
left of the vertical line, shows the debug status of the individual 
files, if this option is chosen from the “Project Window” 
options. If you wish for debugging information to be kept for 
a file, you can click on the diamond to its right and cause the 
compiler to save that information for later use. 

The project window can display a number of different 
types of information at its right side. Each new set of 
information is assigned a column. Figure 1 shows only the 
code size, but you can also display additional information by 
checking the various checkboxes in the “Project Window” 
options, as shown in Figure 2. 


Project Options for “Modeless” 


Options: 


r> Project Window 


te Font: iy] 
Project Size: 


J Icons ] Ascending 


>] Make status [J Location H 
x] Debugging status _] Modification date L 
[] Group X] Code size y 
J Translator CJ Data size 

CL) Projector status 


Hel 
This is the Symantec Project Options dialog. Click on any item to find out more about that option. 


PowerPC C I Cancel 





Factaru Settings 


Cie) 





Figure 2. Project Window Options 


The Project Options dialog shown in Figure 2 also allows 
adjustments to quite a number of other options, including the 
project type, linker option, file extensions, and individual options 
for the C and C++ translators, and the Symantec Rez tool. 
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THE NEW BUILT-IN EDITOR 


The built-in editor is improved significantly. It supports syntax 
coloring — keywords, comments, character constants, string 
literals and preprocessor directives may be styled individually, 
both in their font, size, and style, and also using colors you 
choose. An example of what's available is shown in Figure 3. 





if ‘reason == popupMenuNewSelection 
&& aProvider == fSettings_Options> 
{ 





selecteditem = *(short *) info; 
switch ‘selected! tem> 
{ 






case |: #? Account Options 





if ¢fSubviewiD == kAcctSettings> 
{ 





return; 


fSettingsSuby i ew->Emptys >; ae 
fSettingsSubyiew->SetViewName ¢"\pAcctSettings" >; Se 
fSettingsSubview->Fill<¢>; sae 
fSubviewlD = kAcctSettings; 
break ; 


zs: 
preces: 
z¢ 
Seteees 
$e 








The figure above illustrates coloring of language keywords 
in boldface type, comments in green Geneva 9-point type, and 
a string constant in the standard typeface, colored red. 

Figure 3 also shows “split bars” for splitting the editor window, 
either horizontally or vertically, into as many panes as you desire. 
This feature is very helpful when you want to look at something in 
the file while editing another portion of that same file. 

There are three sets of editor preferences, as shown in 
Figures 4 — 6. These are General Settings, Syntax Formatting, 
and Marker Settings. 


Project Manager Preferences 


:~ Editor Options 


is) General Settings w 


Project Manager |: 


a & Auto indent sseeeeneeeeenenteeeeteeeeeesenesenenesutensenensneeseenecseceseenessesenees, 3 : 


GS 


f Font: iy] : &] Block auto-indent 
Editor | ( Size: | 


|) CJ Show invisibles 


= Delimiter matching sseseensennneneeseneeceeeauaaaneaenausananesseeesneseeeeeeerenesees 3 


_ & Double-click 
_ While typing 


CL] Honor saved font settings 
- Honor saved view settings 
XX] Confirm saves 

>] Projector aware 





J Use ‘*’ for dirty files 
&] Append #-key 
: (] Show full path 








Figure 4. General Editor Settings 
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ANNOUNCIN 


Solutions & 


Ave Computer, Inc., in cooperation with 
JointSolutions Marketing, is pleased to announce 
two new publications designed specifically to reach 
the Macintosh developers market — The Macintosh 
Applications & Parts Developers Guide* and 

The Macintosh Solutions & Multimedia 
Developers Guide. 


To find out more about how you can advertise your 
products in the Guides, call 408/338-6471. 


Don’t miss this opportunity to reach your target 
audience. Call today! 


JointSolutions Marketing JOINT 4 
408/338-6471 | c 
408/338-6475 (fax) FF) 
jsolver@aol.com (e-mail) —“k«ETING 


Closing dates: 
Applications & Parts Guide 5/5/95 


- 


Solutions & Multimedia Guide 8/19/95 OS aa * New title! 


Sean Ese HE 



















You need to protect your software. Hardware vendors will try to convince 
vou that hardware keys are the only secure method of protection. 
They’re wrong. 


Protection is only as effective as the software involved. Most hardware key 
vendors require that you, the developer, spend major resources protecting 
and obscuring the code which interacts with a key. Without this effort on 

your part, your software is vulnerable, even to inexperienced hackers. 


At PACE, we understand that software is the most important 
component of a working protection system. For more than a 
decade we've developed low cost and secure software based 
protection schemes. Our MacEncrypt system will turnkey 
protect your application automatically, applying multiple layers of PACE 
proprietary encryption and self checking algorithms to your product. 


MacEncrypt is a secure, flexible, compatible and low cost protection 
investment. No false promises, wasted development time, upset users 
or expensive chew toys. 


Trust the protection of your software to the people who understand 
software. Call today to order your PACE Developers Kit. 


PACE Anti-Piracy 1082 Glen Echo Ave., San Jose, CA 95125 
Vox: (408) 297-7444 * Fax: (408) 297-7441 ¢ AppleLink: PACE.AP 
email: info@paceap.com » Web page: http://paceap.com/pace.html 








ANTI-PIRACY 


“Our Japanese font supplier imposes 
strict copy-protection obligations 
on Adobe Systems. Because of this, 
we have been using PACE software 
protection on Adobe Type Manager, 
Japanese version and our other 
Japanese font products for almost 
5 years. PACE’s software solution 
provides us with effective security at 
a low cost. Our working relationship 
with PACE is excellent and 
their expert technical staff has 
always been helpful.” 
Paul Anderson 


Senior Director, Pacific Rim 
Adobe Systems, Inc. 





All TE X1 is not 
created equal. 


Is your application taking cut 





So why should you join the 
PAIGE revolution? TIME. Most 
programmers don’t have time to 






& paste a little too literally when 






it creates text? Are you tired of 






living in a monotype world? — reinvent the wheel. 
PAIGE”, our text & page layout 


programming library, is the ulti- 






PAIGE was designed using 






no global variables and machine 






mate cross-platform solution. 
PAIGE provides the most 


sophisticated features/functions 


specific code has been isolated 






into two small source files. This 






strategy allows you to move your 






in the business. These include: application to other operating 






systems or platforms by chang- 





¢ Stylized Text 

e Shapes & Containers 
¢ Text Wrapping 

¢ Embedded Objects 

¢ Hypertext Links 

¢ Virtual Memory 

¢ Style Sheet Support 
¢ Multi-Level “Undo” 

e Royalty Free 






ing only platform specific code 







while maintaining full data and 







application compatibility. 







Join the hundreds of major 
software publishers using PAIGE 
as their total text solution. For 









* complete technical/pricing sum- 
mary contact DataPak Software 
at 800-327-6703 or 206-573-9155. 







Macintosh ¢ Power Macintosh ¢ Windows 





ScriptWizard 


... the essential scripting tool 





ScriptWizard™ brings professional script editing, testing and debugging 
facilities to AppleScript™. Improve your scripting productivity with this 


powerful and intuitive tool! 4-1 /2 mice - MacUser UK 
4 stars - MacWorld UK 


$I 


e Watch Variables 


Variable-watcher shows a 
complete list of variables 
and script properties. 


eFind & Replace 
An irreplaceable tool for 
complex script develop- 
ment and modification. 


e Step-Execution 
Step-execution of scripts 
allows you to step through 
scripts one Apple event at — —— — 
a time. 


Easy Script Navigation 
The "locate" pop-up shows 
all properties and handlers 
defined in your script, and 
instantly jumps to the one 
you choose. 


only 
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File Edit Find Script Windows 







4 by Matt Pauker o 
y in your Startup Items folder, and one 















PRESTR 
Search for | P1| 
L 























set DialooResult to display dialeg “Enter passwo' 
the sk for the ord 


Replace with | Password 
nd &: 











ee 
ss) Refresh inte 
Settings", “Stuffit Deluxe Preferences”, “Stuffit Expander™ F- 1 

" ferences", "Text Viewer Preferences", "Timbuktu : 















hBase Pro 4 Pi s", “Turl 
, "Utah Beach Prefs", "Voyager LD Driver Preferences 
2 s (5) ford Toolbar Prefs", "WordPerfect", "XMODEM Tool Prefs" 





ekim” 
id... ("4D First Prefs", "4D Prefs", "4. 
ath = “Macintosh HD :System Folder :Pre. 










est Pro Prefs"} 
load script file "Macintosh HD ‘System Folder Prefer: 
--> «script Prefs» 








ass ‘d:" default answer “" 





"Its debugging capabilities are a ‘must 
have' for any serious scripter" 
- Dan Shafer: Author, Consultant and Scripting Advocate 


US Offices: 

DZ P.O. Box 700237 San Jose, CA 95170-0237 
Phone: (408)253-7199 Fax: (408)252-2378 
European Offices: 


FULLMOON PO. Box 116 ST ALBANS, Herts, ALI2RL, UK 
SOFTWARE Phone: +44 727 844232 Fax: +44 727 856139 





Project Manager Preferences 


Project Manager sete 


: Comments 

_ |Language Keywords 
__ |Preprocessor Directives| 
_ | String Literals 
_ |Character Constants 





C] Italic 
-] Underline 





Use this pop-up menu to select a sub-category of Editor preferences to set. 


Cancel 





Figure 5. Syntax Formatting Editor Settings 





Project Manager Preferences 





A Marker Pop-up v 
NZ 


ie Include 


= : &] classes 
f &] enums 


] typedefs 


i] functions 


Project Manager 





(] pragma marks 


(] user markers 


&] Show class names 
&] Alphabetize items 


Change selection 
] Show leading comment 


: Use this pop-up menu to select a sub-category of Editor preferences to set. 


Lensesaseeensseneeeseeeeessnneseeseescencansuecneseseenessnsanaausnsssuscesaceauaacnscsecensesesauansenancsaasunsneceuenecensuenenenseesenueeeensessnsueaassuaeucnuaasessaseneussuassssnauaceseneaceusesensueaesuueceenseseusuccnneseeneed 


Figure 6. Marker Pop-up Editor Settings 


As Figure 6 shows, the editor window sports a marker pop 
up menu (as well as a Headers pop up menu). You can choose 
to select how classes, functions, enums, typedefs, etc., are 
marked and in which type style they are displayed in the menu. 
The choices shown in the figures are the factory defaults, but 
they can all be changed to suit your preferences. The Editor 
preferences are selected by choosing Preferences from the 
SPM’s Edit menu. 

In addition to all of the above, the editor supports custom 
key bindings for controlling its various features. There are an 
extensive number of keyboard shortcuts that you can customize 
to suit you. The key binding facility is not documented in the 
User's Guide, but the feature is fully described in the Key 
Bindings sub folder of the Goodies folder, in the CD-ROM 
version of the product. 


THE ONLINE DATABASE 
Symantec has offered the THINK Reference product for quite 
some time; however, previous versions that were included in 
the C++ product have offered only the databases that document 
the standard library functions that are common to ANSI C 
applications. The new Symantec C++ v8.0 product offers the 
entire THINK Reference set of databases, including the newly 
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added THINK Class Library (TCL) database. This set of 
reference material includes almost all of the current Macintosh 
toolbox calls, as well as complete documentation for the TCL, 
its classes and all of its member functions. 


THINK Reference 


seneoncnnnnn 
Ss 


CAppleEventObject::AccessObject 


void AccessObject (DescType desiredClass, 
const AEDese *containerToken, DescType containerClass, 
DescType keyForm, const AEDesc *keyData, 


AEDese *theToken, long theRefcon) ; 


AccessObject returns a token representing the requested property or element. The 
abject that gets the AccessObject call is always pointed to by the containerToken 
argument. The arguments are the same as for the object accessor callback function 
described in Aasiae Mavietest Joteranoircsrica Coanninicslion 





Figure 7. THINK Reference Example 


The TCL documentation includes information to help you 
implement various new features in your applications, including 
extensive documentation of Apple events and Object I/O. 
Figure 7 shows an example of the AccessObject function 
documentation in the CAppleEventObject class of the TCL. I 
found that the THINK Reference product was missing a 
description of the AEResolve function, which is a fairly recent 
addition to the Macintosh OS, in support of the Object Model 
features for Apple events. I suspect that some other recently 
added toolbox functions may also be missing from the 
documentation. However, as it stands, the THINK Reference is 
a godsend to all Macintosh software developers and the 
addition of the TCL database is just frosting on the cake. 

For those of you who are not familiar with the THINK 
Reference product, each of the underlined words in an entry 
(see Figure 7) is a hypertext link that, when clicked, takes you 
to a description of the function, class, structure, or whatever 
else you select. The Go Back button at the top of the window 
allows you to either go back to the immediately previous item, 
or to select from the pop up menu that appears if you hold 
down the mouse button. 

The THINK Reference database is accessible directly from 
the editor, by highlighting a word (function, constant, or 
structure name) and then choosing the Find in Doc Server 
command from the Search menu. Of course, you can also use 
the Command-hyphen keyboard shortcut (or create your own 
keyboard binding) to use this feature. 


THE CLASS BROWSER 
The Symantec C++ v8.0 product has dispensed with the 
graphical browser that was first introduced in version 5.0 of the 
product. Instead, they now offer a browser that is infinitely 
more useful. It shows the class names for built projects in one 
pane—either in alphabetic or hierarchical order—the member 
functions for a selected class in a second pane, the member 
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POSITIONS WANTED 
Available Immediately 1-800-736-3577 


Expert 4D Programmers 
Less than 50¢ per hour- 


More than 1,000 hours of development went ne 
AD Toolkit 2.0. With a one time price of $395.00", 
it’s like hiring a crack team of 4D programmers at 


hour. Call 1-800-736-3577 to 
less than 50¢ perf 10 eerie 


order your copy, of to receive a 


4DTOOLKIET" 


OPtions Computer Consulting 
228 Bleecker Street #19 

New York, NY 10014 

TEL: 212-645-3577 

FAX: 212-633-0336 


* upgrade pricing available 


Version Control 
is a stand alone tool for source code revision control and release 
management 
e Recover past versions of single files or easily 
extract entire releases using snapshots. 
e Track why changes were made, when they were 
made and who made them. 
e Easy checkins with Drag & Drop. 
A complete audit trail of the file history is available for bug tracking, 
source reconstruction & change management. 


A single user license of Version Control is $199, 2 users $249, 
3-5 users $349, and 6-10 users $499. 


Call Tree 


is a stand alone tool for source code analysis which automatically 
produces a function call tree. 
e Quickly understand the design & structure of 
simple or highly complex programs. 
e Identify intentional or hidden modularity for 
optimization & portability. 
Simple to use; yet produces results which saves programmers and 
managers hundreds of hours. 
Call Tree is available immediately for $149. 


ne 
Both Packages are compatible with source for CodeWarrior, MPW, 
Symantec and most other text files containing C source code. 


4822 Santa Monica #179 
BARKING DOG San Diego, CA 92107 
SOFTWARE CO (619) 222-8361 


calltree @ aol.com 
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variables for that class in a third pane, and then provides a 
listing of the selected member function, class header, or 
member variable definition. 


Class Browser 
Classes Functions 


VY x_C App BedVirtualGetClass info fMain_Pict1 
CApp DoCmdOpenSettings fMain_Stat2 
7 CDirector DoCommand gAncestorOffsets 
> CClipboard FailOpen gAncestors 
> CDialogDirector Ix_CMain gClassInfo 
7 CDocument 
W CSaver <CCollabor ator > PositionWindow 
YT x_CMain UpdateMenus 
CMain 
CSimpleSaver 
> CFloatDirector 
CPopupMenu 
> C¥iew 





Source 


Woid x_CMain: :MakeNewWindow(void)> 
{ 


itsWindow = TCLGetNamedWindow<"\pMain", this); 
itsMainPane = ¢CPane*> TCLGet!temPointer<itsWindow, 0); 
/f Initialize pointers to the subpanes in the window 


fMainPict! = ¢(CPicture*> itsWindow->FindViewBylO¢kMainPict11D); 
ASSERT (member ¢ fMainPict!, CPicture >); 


fMain_Stat2 = (CStaticText#*> itsWHindow->FindViewBylO¢kMain_StatZ1D); 
ASSERT (member ¢ fMain_Stat2, CStaticText >; 





Figure &. New Class Browser 
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The new class browser is shown in Figure 8. The figure 
illustrates the hierarchical class view in its left pane, the 
member functions for that class in the middle pane, the 
member variables in the right pane, and the source code for the 
MakeNewWindow (selected function) in the bottom pane. The 
source code can be modified using the same features as the 
standard editor, and it also displays the same type of syntax 
formatting as the standard source code editor. I have found 
that the new browser is much more useful than the graphical 
browser provided with earlier versions of the product. 


THE NEw DEBUGGER 
In addition to a new development environment, new editor, 
and new class browser, the version 8.0 product has a new 
debugger. For several years, people who have used the THINK 
Pascal debugger and loved its ability to display the stack when 
you breakpoint into a procedure, have pleaded with Symantec 
to provide this same type of display for their THINK C and then 
the Symantec C++ products. Well, with version 8.0 of the 
symantec C++ product this facility is finally available. The new 
debugger displays the source code, but also provides’ a full 
stack crawl, with symbolic names of variables and objects, and 
it allows you to expand or collapse the listing with a simple 
twist of a control. Figure 9 illustrates a view of the debugger 
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when it has stopped at a breakpoint, with the context of the 
current member function shown in the stack crawl window. 


#_CMain.cp 
Stack Crawl 


7 x_Chain: -DoCadOpenSeattingstvsia> 
v— dialog 
> i tsProviders 
> i tsDependents 
> itsSupervisor 
> itsDirectors ox00000000 
active Ox6E 
> i tsWindow Ox 1340F FFD 


void x_CMain: :DoCmd0pensettings® > 
4 


CSettings #dialog; 
/? Respond to command by opening a dialog 


dialog = TCL_NEWCCSettings, ¢ 99; 
dialog-? |CSettings¢ this); 


dialog-+BeginDialoag?’ >; 





Figure 9. New Debugger With Stack Crawl Shown 


Figure 9 shows the debugger stopped in the 
DoCmdOpenSettings function in the bottom pane of the 
debugger window. The top pane provides the symbolic names 
of variables (or objects) in its left side and the values associated 
with these in its right side. The individual panes can be resized 
to suit your needs. 

In addition to the debugger’s main window, Figure 9 
shows the floating Control palette above the main window. 
You can position this palette wherever you like, and it lets you 
control running, stepping, stopping, stepping into or around 
functions, or tracing until a function is called. The palette can 
be hidden by clicking in its close box, and you can issue debug 
commands by choosing them from the Debug menu or by 
using their Command-key equivalents. 

The debugger also offers a Data window, which evaluates 
and displays the results of expressions you type in. That 
window is very much like the Data window in the TPM 
debugger environment. You can also open multiple debug 
browser windows. This allows you to look at several different 
contexts at the same time, which is handy if you want to look 
at several levels of the stack and compare the values of various 
arguments, for example. 

There is no doubt that the new debugger offers many of 
features that we have requested from Symantec. They are 
definitely listening. 


THE VISUAL ARCHITECT 
The Visual Architect (VA) lets you create a graphic user interface 
and then it generates skeleton code to implement that interface. 
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The VA can be used only with THINK Class Library projects, but 
aside from that limitation, it’s a marvelous application 
development tool. The VA remains virtually the same as what is 
offered in the previous version of the Symantec C++ product. 
There have been numerous changes to the code generation 
templates and fixes to the VA itself, but the product is basically 
the same. Compatible versions for both 68K and Power 
Macintosh development are offered in the Symantec C++ v8.0 
product. The TCL is also shared by both versions of the VA. 


ADDITIONAL FEATURES | 

The new product also offers a major subset of the “Standard 
Template Library” developed by Hewlett Packard. In addition, 
you can create shared library versions of your projects, which 
will enable you to create a single version of the THINK Class 
Library and share it with multiple projects. Although Symantec 
has offered the ability to include libraries into projects for quite 
a long time, you have never been able to debug the library 
source code in previous versions of the product. By creating a 
VA application with shared TCL, you can include a compiled, 
shared-library version of the TCL into your projects and also 
debug the TCL at the source code level. This is a major new 
feature that should really help reduce the disk bloat resulting 
from keeping many big project files current. 
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CROSS-PLATFORM DEVELOPMENT 


The new version of Symantec C++ v8.0 supports cross-platform 
development by providing two separate development 
environments. The previous version of this product, Symantec 
C++ v7.0, has been revised, bugs have been fixed, and the 
THINK Project Manager (TPM), its compilers, linker, and built- 
in editor are included along with the new Power Macintosh 
(SPM) development environment. The Visual Architect, THINK 
Class Library, and other library sources are common to both the 
TPM and SPM development environments. 

Development of two versions of an application—one for 
68K users and another for PPC users—requires that the 
developer create two separate projects—one for the TPM 
and another for the SPM. This is a problem that Symantec 
intends to relieve by providing new versions of the 
compilers, linker, and debugger that will execute in the SPM 
environment, on either 68K or PPC platforms, and generate 
and debug 68K target code. At the present time, both the 
SPM and TPM execute on either platform, but the generated 
code is targeted for either the 68K (with the TPM) or the PPC 
(with the SPM) environment. 
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Figure 10. Merging a 08K Built Application 


Fat applications—those that run on either the 68K or PPC 
platforms—are built rather easily once a 68K version of the 
application has been built. Figure 10 shows the Project 
Options dialog in the SPM, for the Project Type settings, with 
the Merge 680x0 Application checkbox checked, and the Select 
Application button being pressed. When that button is pressed, 
a Standard File dialog opens, allowing the developer to choose 
the built 68K application whose code resources are to be 
merged into the current SPM project. When the application 
associated with the current project is built, then the 68K code 
resources are merged into the final binary, automatically. 

It is important to point out that only fat applications can 
be built with the Merge option in the SPM environment. It is 
not possible to build fat code resources of any kind. I believe 
that this is a sensible restriction. Control panels, extensions, 
and other “system” components should be built especially for 
the environment in which they will run. 


SOME REMAINING PROBLEMS 

As good as the new Symantec C++ v8.0 product is, it still has a 
few flaws. Many of these have already been corrected within 
Symantec’s development organization and an update to the 
symantec v8.0 product is expected to be available by the time 
this article appears. The update version will be 8.0.1. Some of 
the problems that have been reported and fixed, or for which 
workarounds exist are as follows: 

In some cases, the debugger will crash either when it is 
first opened or when it is closed. These crashes are almost 
always caused by problems in the debugger’s storage of 
breakpoint and expression data from run to run. If a crash 
occurs when the debugger is first opened (i.e., you choose Run 
with Debugger from the Project menu), then you should launch 
the debugger the next time by holding down the Option key 
when you choose Run with Debugger until the Source window 
appears. This will cause all of the breakpoint and expressions 
to be disposed, but should eliminate the crash. If the debugger 
crashes when you quit the application being debugged, then 
the work around is to throw away the “Symantec Debugger 
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Prefs” file in the Preferences folder of your System Folder. This 
will cause the saved window locations and other preferences 
information to be disposed, but by performing this step, the 
debugger should exit normally when you quit the application. 

There are a few incompatibilities between the Symantec 
Debugger in the SPM environment and Apple’s System 7.5.1 
update. These should be fixed by the version 8.0.1 update. 

In a few cases, keying in an expression into the debugger’s 
Data window will result in the display of an Alert that indicates 
an “Internal Error.” There is no published date for the 
correction of this problem. All I can say is don’t enter that 
expression into the Data window. Perhaps Symantec will be 
encouraged to fix this problem shortly. The problem occurs 
only rarely and should affect only a few users, in special 
circumstances. 

Some templates defined in typedef statements aren't accepted 
by the current PPC C++ compiler. This problem is fixed in the 
version 8.0.1 update. This update is available at ftp.info.apple.com, 
devtools.symantec.com, and www.symantec.com. 

A few problems related to the generation of incorrect 
optimized code by the PPC C++ compiler have been reported. 
Most of these have been fixed and the correct code for these 
will be generated by the updated v8.0.1 compiler. 


Wuat ABout DOCUMENTATION? 
The Symantec C++ v8.0 product ships with only two manuals. 
One is the “User’s Guide” and the other is the “Compiler 
Guide.” The THINK Class Library reference book is not 
provided, mainly because all of that documentation is available 
in the THINK Reference online hypertext database. In addition 
to the manuals, Symantec provides quite a bit of documentation 
in the form of electronic files. For some, the loss of the TCL 


JUNE 1995 @ MACTECHMAGAZINE 





International shipping (US Airmail) $10 
No royalty fees for applications 


manual will be severe. I thought that I would miss it, but I 
found that the TCL documentation in THINK Reference was so 
accessible that I really don’t miss the paper documentation. 


THE BOTTOM LINE 

I found the new Symantec C++ v8.0 development environment 
to be very efficient and full of helpful tools. In the course of 
developing code for my new book, I used the class browser, 
the THINK Reference database, and the debugger a great deal. 
I was constantly creating new Visual Architect projects and 
recompiling. In so doing, I found that the compilers and linker 
were extremely efficient and I never felt like I really had the 
time to go out for coffee while a compilation was in progress. 

One possible problem for some people might be the 
amount of RAM required to run the new environment. The 
SPM requires 8 Mb of RAM to run and you need to add the 1.5 
Mb required by the debugger, and also the amount of RAM 
required for your application, in order to run within the 
environment. My Power Macintosh 6100 with 24 Mb of RAM 
had no difficulty running this and several other applications 
simultaneously; however, a pristine 8 Mb Power Mac is not 
going to hack it with this environment. 

Also, I’m sorry that exception handling hasn’t yet made it 
into the compiler. This feature is still provided through the use 
of macros that are part of the TCL. In addition, templates must 
still be expanded explicitly. Perhaps these two drawbacks will 
be resolved in a future update to the product. 

All in all, the product is incredibly good. I think that 
maybe Symantec has made life too easy for me. 
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By Michael Hopkins and Craig Conner, Symantec Corp. 


This column, written by 
Symantec’s Technical Support 
Engineers, is dedicated to 
answering common problems 
relating to Symantec C++ 8.0 
for Power Macintosh. 


Q: I have made some modifications to 
some of the ANSI library sources and I 
want to have PPCANSI.o use my new 
versions of those sources. Can I rebuild 
PPCANSI.0 using the Symantec Project 
manager, or do I have to use MPW? 


A: You can build PPCANSI.o directly 
from Symantec C++ 8.0 for Power 
Macintosh. There is a ready-made 
project, PPCANSI_XCOF.7 in 
Standard Libraries:Headers and Source, 
that you can recompile. However, for 
the purpose of illustrating how to create 
static libraries, we will discuss how to 
convert PPCANSI .7 to a static library. 
First, make a copy of PPCANSI.m 
(in the Standard Library folder ). Open 
the copy and remove the following files: 
InterfaceLib.xcoff, 
MathLib.xcoff, and 
shlbPPCRuntime.o. Now, go to the 
Project menu and select Options to 
bring up the options dialog for your 
copy of PPCANSI.7. Select Project 
Type from the scrolling list. From the 
Project Type Popup Menu, choose 
Static Library. Dismiss the alert 
dialog “You cannot build Static Libraries 
using the Incremental Linker. Change to 
use PPCLink & MakePEF?” by clicking 
the Change button. Now the File Type 


should read XCOF and the Creator 


should be RAIN. (See picture below) 
Click on the Set destination... 
button and navigate the 
StandardPutFile dialog to select the 
destination for your built library. Your 
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target name should be PPCANST .o (or select another name if you 
don’t want to replace your default ANSI library.) 

You can save these options your version of PPCANSI.o 
by selecting Save Options As... from the Options popup 
menu. Enter the name of your option set in the edit box and 
click on the Save button. Now exit the Project Options 
dialog by clicking the Save button at the bottom of the dialog. 

To use your newly created option set, go to your project 
window and select the name of your newly created option set 
from the Options popup menu (see picture below). Before 
you build your library, make sure that you have an alias to 
ToolServer in your (Tools) folder. Then choose Build 
Library from the Build menu to create a new .o file. 


So Pro, Options for “PPCANSI.1” a nena 
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Choosing the Project Option Set 


Q: I am trying to open my application from the Finder by 
selecting a group of documents and double clicking on one of 
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them. In my application code, I use CountAppFiles() to 
determine how many files the user selected, and it doesn’t 
seem to work on my PowerPC. This code used to work fine on 
my 68K machine. What is the matter? 


A: CountAppFiles(), GetAppFiles(), 
ClrAppFiles(), GetAppParms(), and 
getappparms() are not supported on the PowerPC. You 
must use AppleEvents to determine how many files need to be 
opened. See Inside Macintosh: Interapplication Communication 
for more information on how to use AppleEvents. 


Q: I am going through the Hello World C++ Application tutorial 
on page 10-15 of the user’s guide and I get a bunch of link 
errors. How can I resolve these problems? 


A: There is a omission in the manual. You will need to add 
InterfaceLib.xcoff and MathLib.xcoff to your 
project. These libraries are in the PPC Libraries folder within 
the Macintosh Libraries folder. 


Q: I am writing a C++ program using IOStreams and when I 


compile it in Symantec C++ 8.0, I get “Internal Error: cgfunc.c 
line 1476”. How do I get around this problem? 


EJ SYMANTEC Top 10 








A: This internal error is caused by having too many 
expressions following a cout statement. For example: 


cout <<“x"<<endl <<“x”"<<endl <<“x"<<endl <<“x"<<endl 
CC“x"<Cendl <<“x"<<endl <<“x"<<endl <<“x"<<endl 
<<"x"<“Sendl <<"x"<<end] <<“x"<<end] <<“x"<<end1 
C<“x”"<Kend] <<“x"<<endl <<“*x”"<<endl <<“x"<<endl 
K<“x"<Cendl <<“x"<<endl <<“x”’<<endl <<“x"<<endl 
CC“x"<Cendl <<“x”"<<endl <<“x”"<<endl <<“x”<<endl; 


























Split up the statements above to correct the problem. In 
some cases, this error message will occur several lines after the 
actual cause of the problem. 


Q: I am getting link errors with CtoPstr and PtoCstr. Am I 
missing a library, or are these functions no longer available’? 


A: CtoPstr() and PtoCstr() have been renamed as 
c2pstr() and p2cstr(). To use them, you need to 
include the Apple header file Strings.h. 


Q: When I choose “Run with Debugger” from the Project menu, 
the debugger launches, but then I get returned to the Project 
Manager. Why does this happen? 


A: The Symantec Debugger is dependent upon the Apple 
application Power Mac DebugServices to provide low- 
level debugging services for PowerPC executables. If 
DebugServices is not working properly, the Symantec 
Debugger will not run. Here are some things to check or try... 


e Make sure that you have Power Mac DebugServices on 
your local hard drive. It should be located in your (Tools) 
folder in your Symantec C++ for PowerMac folder. 

e If you are not using System 7.5, make sure that you have 
ObjectSupportLib, PPCTraceEnabler, and 
AppleScriptLib in your system folder. These items 
can be found on your CD in the Apple Software folder, and 
then in the Pre-System 7.5 Additions folder. 

e If you are using System 7.5, try turning off all of your 
extensions and rebooting. Debugger Nub Controls, 
PPC Debugger Nub, and PPCDebuggerNub INIT in 
particular may conflict with the Symantec Debugger. 

e Throw away the Symantec Debugger Prefs file located in 
the Preferences folder of your system folder. 


Q: I just got System Update 7.5.1 and when I run my application 
under the Symantec Debugger, I get “The application 
‘appname.pef could not be launched because of an unknown 
reason (error = -27324).” What is wrong with the debugger? 


A: Nothing is wrong with the Symantec Debugger. The 
problem lies with Power Mac DebugServices which is not 
compatible with System 7.5.1. You need to get Power Mac 
DebugServices 2.0b14 or later to resolve this 
incompatibility; available from Apple Computer, or as part of 
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our latest free online upgrade. 

<ftp://devtools.symantec.com/macintosh/updaters/devtools/ 
sym.cpp-va-tcl.updates/> 

<ftp://ftp.info.apple.com/Apple.Support.Area/Developer_Services/ 
Tool_Chest/Testing_&_Debugging/ 
PowerMacintoshDebugging/Power_Mac_DebugServices_v2.0b14/> 


Q: Why is the menu option for Run with Debugger is grayed 
out? 


A: To run with the debugger, you need to have linked with the 
Incremental Linker, by choosing Incremental linker in the Linker 
page of the Project Options dialog, and set the project to 
Application. You will not be able to debug the executable if 
you use PPCLink & MakePEF, or have selected a static or shared 
library as the project type. 


Q: Why doesn’t the Project Manager automatically detect 
changes to my source files made by external editors and 
recompile them when I run? | 


A: The Project Manager will automatically detect changes to 
your source files if you are using an external editor that 
supports the new Symantec Project Manager editor interface. 
Otherwise, you will need to enable the check box Always 
check file dates from the Project page of the Project 
Options dialog. 


Q: When I use the Find command in the editor, it always 
searches forward. Is there any way to make it search backward? 


A: Yes. When you use the Find command from the search 

menu, it will find the first instance of the search string starting 

from the current insertion point. Command-G finds the next 

matching string, while Command-Shift-G finds the previous 

matching string. You can find other special features by 

experimenting with modifier keys while pulling down menus. 

The following are additional features of Symantec C++ 8.0: 

e Double-clicking on either an open brace ‘{’ or close brace ‘}’ 
in the editor will select the text between the matching 
braces. 

e Command —> expands groups in the project window 

e Command <— collapses groups in the project window 

e Holding down the command key while scrolling windows in 
the editor makes scrolling twice as fast. 

e Holding down the option key while scrolling accelerates 
scrolling by a factor of three. 


Special Thanks to: Mark Baldwin, Glenn Austin, Phil 
Shapiro, Thomas Emerson, Colen Garoutte-Carson, Rick 
Hartmann, Kevin Quah, Steve Howard, Scott Morison, Levi 
Brown, Noah Lieberman, and Andy McFarland. 
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By Bob Boonstra and Mike Scanlin 








GOODBYE FROM MIKE 


This month is a special month. I have decided to turn the 
Programmer Challenge over to Bob Boonstra. Readers of this 
column will recognize Bob’s name from his many excellent 
winning solutions to the Challenges I’ve posed. In fact, Bob is 
the proud owner of six Ist-place showings. I can think of no- 
one I'd rather turn this column over to than Bob. I will judge 
the last two puzzles I have posed and Bob will judge the 
puzzles he poses (the first of which, Check Checkmate, is in this 
issue). 

It’s been almost three years since I first started this 
column. While it has been incredibly rewarding to see so 
much optimal code and meet so many like-minded efficiency 
nuts, my life has changed during those three years and I no 
longer have the time that this column deserves. Even though I 
won't be writing it any more I'm sure this column will remain 
my favorite part of MacTech (I may even submit an entry once 
in a while...). 

Thanks to everyone who took the time to write to me over 
the years with suggestions for Challenges. I have given Bob the 
compiled list of ideas. I’m sure he'd love to hear from you if 
you have any other ideas or comments on what you want to 
see in this column. I leave you in Bob’s capable hands... 


Optimally yours, 


Mike Scanlin 
scanlin@genmagic.com 


CHECK CHECKMATE 
This month’s Challenge deals with the game of chess. 
You will be given a chess position and asked to produce the 
list of moves and captures that it is legal for one of the sides 


Here’s how it works: Each month we present a new | 
programming challenge here. First, write some code that solves 
the Challenge. Second, optimize your code (a lot). Then, submit your solution 
to MacTech magazine. We choose a winner based on code correctness, speed, 
size, and elegance (in that order) as well as the postmark of the answer. In the 
event of multiple equally desirable solutions, we'll choose one winner at 
random (with honorable mention, but no prize, given to the runner up). The 


prize for each month’s best solution is $50 and a limited-edition, “The Winner! 
MacTech Magazine Programming Challenge” T-shirt (not available in stores), 
Unless stated otherwise in the problem statement, the following rules 
apply: All solutions must be in ANSI compatible C. We disqualify entries with 
any assembly in them. You may call any Mac Toolbox routine (e.g, NewPtr 
instead of malloc). Compiler code generation options will be set to disable FPU 
use (for 680x0 code) and to enable all available speed optimizations. The 


to make in accordance with the rules of chess. The objective is 
to produce the legal move list in minimum time. 
Here are the prototypes for the routines you should write: 


typedef enum {rowA=0,rowB,rowC,rowD,rowE, rowF,rowG,rowH} Row: 
typedef enum {coll=0,col2,c013,c014,c0l5,col6,co0l17,col8} Col; 
typedef enum {whiteSide=0,blackSide} Side; 

typedef enum {king=0, queen, rook, bishop, knight,pawn} ChessPiece : 


typedef struct Square { 
Row row; 
Vol cols 

} Square; 


typedef struct PiecePosition { 
Square sq; 
Side side; 
ChessPiece piece; 

} PiecePosition; 


typedef struct ChessMove { 
Square fromSq; 
Square toSq; 
Boolean movelsCapture; 
Boolean opponentPlacedInCheck; 
} ChessMove; 


short /*numberOfMoves*/ LegalChessMoves ( 
PiecePosition piecePositionArray([], 
short numberOfPieces, 
Side sideToMove, 
ChessMove legalMoveArray[], 
void *privateDataPtr 


ys 


void InitChess(void *privateDataPtr) ; 


This Challenge will consist of one call to InitChess, 
followed by multiple calls to LegalChessMoves. The InitChess 
routine will not be timed, and may initialize up to 32K bytes of 
storage preallocated by my testbench and pointed to by 
privateDataPtr. Your program should not use any static storage 
besides that pointed to by privateDataPtr. 

Each call to LegalChessMoves will provide a 
piecePositionArray containing numberOfPieces chess pieces. 


compiler to be used and the target instruction set (680x0 or 
PowerPC) will be stated in the problem. Limit your code to 60 
characters per line; this helps with e-mail gateways and page layout. 
You can get a head start on the challenge by reading the online version. 
We post it to the online services at the same time that we post source code. We 
make every effort to have it online no later than when the magazines are 
mailed, but we're unable to guarantee that it will be online by any given date. 
Mark solutions “Attn: Programmer’s Challenge Solution” and send it by e- 
mail to one of the Programmer's Challenge addresses in the “How to 
Communicate With Us” section on p. 2. MacTech magazine reserves the right to 
publish any solution in the Programming Challenge of the Month. Authors grant 
MacTech Magazine the exclusive right to publish entries without limitation upon 
submission of each entry. While authors retain copyright for the code submitted, 
they grant readers a license to use the code submitted as part of larger works. 
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Each piece is described in a PiecePosition struct containing the 
ChessPiece, Side, and position. The position is provided as a 
Square struct containing a Row and a Col, where rowA 
represents the starting row for the White major pieces, and 
rowH the starting row for Black. The columns are numbered 
from left to right as viewed from the White side, so that (rowH, 
‘col4) is the starting square of the Black queen in a new game. 
The piecePositionArray will describe a legal set of chess piece 
positions, anything from the initial positions in a new game to 
an end-game position. No position will be provided that could 
not be reached during a chess game. Remember that due to 
past pawn promotions, a side may have (for example) more 
than one queen. You should generate the moves for the side 
provided in sideToMove. The privateDataPtr parameter will be 
the same pointer provided to InitChess. 

LegalChessMoves should store in legalMoveArray the 
complete list of legal ChessMoves for the sideToMove. The 
legalMoveArray will be allocated by my testbench and will be 
large enough to hold all of the legal moves for the given chess 
position. You should describe each legal move/capture by 
placing the row/col location of the moving piece in fromSq and 
the rol/col of the destination in toSq. In addition, for each move, 
the Boolean movelsCapture should be set to true if the move 
captures an opponent's piece (and set to false otherwise). 
Similarly, the Boolean opponentPlacedInCheck should be set to 
true if the move places the opponent in check (and set to false 
otherwise). The return value of the function should be the 
number of moves stored in legalMoveArray. In generating the 
list of legal moves, you should assume that castling moves or en 
passant pawn captures cannot occur. Remember that it is not 
legal to make a chess move which places or leaves the moving 
side's king in check. If the sideToMove has been checkmated 
and cannot move, LegalChessMoves should return zero. 

This month brings one change to the rules of the contest. 
From now on, with apologies (and sympathies) to any MacPlus 
users still out there, the 68020 code generation option will be 
turned ON. This Challenge will be scored using the THINK C 
compiler and 68K instruction set, but future Challenges will 
include occasional use of the CodeWarrior compiler and/or the 
PowerPC instruction set. This month, you should also include 
the following pragmas in your code: 


#pragma options (mc68020, !mc68881, require_protos) 
Fpragma options (pack_enums, align_arrays) 


Have fun, and e-mail me if there are any questions. 


Two MontHs AGO WINNER 

I guess most people spent the beginning of April working 
on their taxes instead of the Stock Market Database Challenge 
because I only received 3 entries. Of those, only two worked 
correctly. Despite the lack of competition, I’m happy to say that 
the winning solution is quite good. Congratulations to Xan 
Gregg (Durham, NC) for his efficient solution. And thanks to 
Ernst Munter for taking the time to enter. Ernst was at a bit of a 
disadvantage, considering he had to develop his code on a 
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DOS-based machine that didn’t have the RAM or disk space 
specified in the problem. 

Here are the times and code sizes for both entries. 
Numbers in parens after a person’s name indicate that person’s 
cumulative point total for all previous Programmer Challenges, 
not including this one: 





Name time code 
Xan Gregg (4) 3523 1766 
Ernst Munter (53) 61714 3470 





The key to implementing a fast database where not 
everything fits into RAM is to have fast RAM-based indexes to 
your disk-based data and to minimize disk accesses. Also, for 
those times when you do read/write to the disk it’s really 
important to do it in even sector amounts. Xan uses 8K 
reads/writes. Sectors on most devices are 512 bytes each so 8K 
is a good choice. If your application ever needs to swap data to 
disk then you should study Xan’s code. It could save your users 
a lot of time. 


Top 20 CONTESTANTS OF ALL TIME 
Here are the Top 20 Contestants for the 34 Programmer’s 
Challenges to date. The numbers below include points awarded 
for this months’ entrants. (Note: ties are listed alphabetically by 
last name — there are 24 people listed this month because 7 
people have 20 points each.) 


1. Boonstra, Bob 176 
2. Karsh, Bill 71 
3. Stenger, Allen 65 
4. Munter, Ernst 63 
5. Larsson, Gustav 60 
6. Riha, Stepan 51 
7. Goebel, James 49 
8. Cutts, Kevin 46 
9. Nepsund, Ronald 40 
10. Vineyard, Jeremy 40 
11. Darrah, Dave 34 
12. Mallett, Jeff 34 
13. Landry, Larry 29 
14. Elwertowski, Tom 24 
15. Gregg, Xan 24 
16. Kasparian, Raffi 24 
17. Lee, Johnny 22 
18. Anderson, Troy 20 
19. Burgoyne, Nick 20 
20. Galway, Will 20 
21. Israelson, Steve 20 
22. Landweber, Greg 20 
23. Noll, Bob 20 
24. Pinkerton, Tom 20 


There are three ways to earn points: (1) by scoring in the 
top 5 of any challenge, (2) by being the first person to find a 
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bug in a published winning solution or, (3) being the first 
person to suggest a challenge that I use. The points you can 
win are: 


1st place 20 points 
2nd place 10 points 
3rd place 7 points 
4th place 4 points 
5th place 2 points 
finding bug 5 points 


suggesting challenge 2 points 


Here is Xan’s winning solution: 


/* OVERVIEW market.c — by Xan Gregg 

I cache all symbol names in memory and as many blocks 

of trade data from disk as possible are cached in the rest 

of the allowed memory. For each symbol I keep a “pointer” 
(block# and entry#) to the most recent trade involving that 
symbol. Each trade points to the previous trade of that 
symbol. 


The header includes an array of 26K entries in which each 
entry points to a list of symbols. All symbols with the 
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same first three letters are on the same list. So the array 
of symbol lists is indexed by the first three letters. 


The trade data are stored on disk as a summary of the trade 
information passed to NewTradeQ. The time is stored in 

a long, and the volume is stored as a daily cummulative 
value. The data is accumulated into a 8K block which 

is written to disk when it gets full. 


I know that there will be under 500,000 trades (since 

the trade is at most 10MB and each Trade struct is 22 
bytes). And I have been told there will be about 10,000 
symbols and at most 16K. So that puts each symbol at 

an average of 50 trades each. That’s good for my approach 
of indexing by the symbol name. However, since I iterate 
through the list of trades in reverse order, I am at a 
disadvantage if a lot of older data is requested. 


/ 
typedef unsigned char uchar; 


typedef unsigned shortushort; 
typedef unsigned long ulong; 





typedef struct TimeStamp 
uchar yearsFroml900; 
uchar month; 
uchar day; 
uchar hour; 
uchar minute; 
uchar second; 

} TimeStamp; 








typedef char Str7[8]; 


typedef struct Trade { 


Str7 symbol; 

TimeStamp time; 

Fixed price; 

ulong numShares; 
} Trade; 


void *InitTradeDatabase(ulong maxRAM) ; 

void NewTrade(void *privateDataPtr, Trade trade); 

Fixed PriceIs(void *privateDataPtr, Str7 symbol, TimeStamp time) ; 
ulong VolumeIs(void *privateDataPtr, Str7 symbol, TimeStamp time); 


#define kBlockSize 8192L 

#define kBlockEntries (kBlockSize/16) 
#define kFileSize (8*1024L*1024L) 

/* enough to store 500,000 trades */ 
#define kNumBlocks 1024L 











#define kNumSymbolIndices (26*32*32L) 
define kSecondsPerDay (60L*60L*24) 





typedef struct SymbolEntry SymbolEntry; 


struct SymbolEntry 


long restOfSymbol; /* last 4 chars */ 
SymbolEntry *next; /* with same Ist 3 chars */ 
short latestBlockNum; /* location on disk */ 
short latestEntryNum; /* location with block */ 


i 


/* 16-byte struct stored on disk for each trade */ 
typedef struct 
{ 
/* seconds since 1904 */ 
/* same as from Trade record */ 


ulong seconds; 
Fixed price; 


ulong totalShares;  /*current and previous */ 
short  prevBlockNun; 
short prevEntryNum; 


typedef struct 
{ 


TradeSummary data[kBlockEntries] 
short blockNum; /* where it is on disk */ 
short filler; 

} CachedBlock; 
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typedef struct 
{ 

CachedBlock *blockLocation[kNumBlocks]; /* 4KB*/ 
Pie symbolDataEnd; 
CachedBlock ‘*lowestBlockP; 
CachedBlock ‘*highestBlockP; 
.CachedBlock *oldestBlockP; 
CachedBlock *currentOutBlockP; 


short currentEntryNum; 
short refNun; 
ParamBlockRec pb; 
ushort symbolIndex[kNumSymbolIndices]; /* 26KB */ 
SymbolEntry symbols[1]; /* variable length */ 
} Header; 


/* the above struct takes less than 32K, and the 
symbol data takes less than 192K (assuming a max of 
16K symbols), so the cached blocks can use everything 











after the first 224K */ 

#define gBlockLocation dataP->blockLocation 
define gSymbolDataEnd dataP->symbolDataEnd 
#define gLowestBlockP dataP->lowestBlockP 
#define gHighestBlockP dataP->highestBlockP 
#define gOldestBlockP dataP->oldestBlockP 
#define gCurrentOutBlockP dataP->currentOutBlockP 
define gCurrentEntryNum dataP->currentEntryNum 
#define gRefNum dataP->refNum 

#define gPB dataP->pb 

#define gSymbolindex dataP->symbolindex 
define gSymbols dataP->symbols 


void *InitTradeDatabase(ulong maxRAM) 
{ 

Header "aatar: 

CachedBlock *blockP; 


maxRAM = maxRAM & -4L; /* make sure end is aligned */ 
dataP = (Header *) NewPtrClear(maxRAM) ; 
if (dataP == 0) 

DebugStr(“\p NO MEM”) ; 


/* skip the first symbol as 0 is not a valid index */ 
eSymbolDataEnd = (Ptr) (gSymbols + 1); 


/* Initialize memory blocks at end of data area. */ 
blockP = (CachedBlock *) (((Ptr) dataP) + maxRAM) ; 
gCurrentOQutBlockP = blockP - 1; 
/* leaving 224K for headers and symbols */ 
while ((Ptr) (blockP - 1) > ((Ptr) dataP) + 224*1024L) 
{ 
block?=; 
blockP->blockNum = -1; 
} 
gLowestBlockP = blockP; 
gHighestBlockP = gCurrentOutBlockP; 
gOldestBlockP = gHighestBlockP - 1; 
eCurrentOutBlockP->blockNum = 0; 
gBlockLocation[0] = gCurrentOutBlockP; 


/* create swap file */ 

OSErr err; 

long size; 

err =-Create(“\pXansSwapFile”, 0, ‘xxxx’, ‘DATA’); 
if (err) 

{ 





FSDelete(“\pXansSwapFile”, 0); 
err = Create(“\pXansSwapFile”, 0, ‘xxxx’, ‘DATA’); 
if (err) 

DebugStr(“\p NO FILE”); 
FSOpen(“\pXansSwapFile”, 0, &gRefNum) ; 
if (gRefNum == 0) 

DebugStr(“\p NO FILE”); 
size = kFileSize; 
err = AllocContig(gRefNum, &size) ; 
size = kFileSize; 
if (err) 
err = Allocate(gRefNum, &size) ; 
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if (err) 
DebugStr(“\p NO FILE”) ; 
SetEOF(gRefNum, kFileSize) ; 


return (void *) dataP; 


/* Take a chance and use OS trap here. If assembly 
were allowed could at least cache the address of the 
code and call it with a function pointer instead of 
through a trap, or we could just write this whole 
routine is assembly. 
* 
/ 
ulong timeToSeconds(TimeStamp *timeP) 
| DateTimeRec dateTime; 

ulong seconds; 


dateTime.year = 1900 + timeP->yearsFrom1900; 
dateTime.month = timeP->month; 

dateTime.day = timeP->day; 

dateTime. hour = timeP->hour; 

dateTime.minute = timeP->minute; 
dateTime.second = timeP->second; 
Date2Secs(&dateTime, &seconds) ; 

return seconds; 








/* returns 0 if the symbol was not found */ 
SymbolEntry *findSymbolEntry(Header *dataP, Str7 symbol) 
{ 


register long rest; 
register SymbolEntry *symbolP; 
long memRest ; 
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short keyIndex; 

ehar secondChar; 

char thirdChar; 

char “Ds 

short len = symbol [0]; 


/* figure the keyIndex (first three letters) */ 
if (len < 2) 
{ 
secondChar = 0; 
thirdChar = 0; 


else 
{ 
secondChar = symbol[2] - ‘@’; 


if (len != 2) 
thirdChar = symbol[3] - ‘@’; 
else 
thirdChar = 0; 
} 


keyIndex = ((symbol[1] - ‘A’) << 10) 
| (secondChar << 5) | thirdChar; 


/* and the ‘rest’ (last four letters) */ 
memRest = 0; 
p = (char *) &memRest; 
while (len > 3) 

*pt+ = symbol [len-]; 


rest = memRest; 
if (gSymbolIndex[keyIndex] == 0) 
symbolP = 0; 
else 
{ 
symbolP = &gSymbols[gSymbolIndex[keyIndex]] ; 
while ((symbolP != 0) 
&& (symbolP->restOfSymbol != rest)) 
symbolP = symbolP->next; 
} 


return symbolP; 


/* like findSymbol, but inserts it if necessary */ 
SymbolEntry *findInsertSymbolEntry (Header *dataP, 


Str7 symbol) 


register long rest; 
register SymbolEntry *symbolP; 
long memRest ; 

short keyIndex; 

char secondChar; 

char thirdChar; 

char “Dp: 

short len = symbol [0]; 


/* figure the keyIndex (first three letters) */ 
if (len < 2) 
{ 
secondChar = 0; 
thirdChar = 0; 


else 
{ 
secondChar = symbol[2] - ‘@’; 


if (len != 2) 

thirdChar = symbol[3] - ‘@’; 
else 

thirdChar = 0; 


keyIndex = ((symbol[1] - ‘A’) << 10) 
| (secondChar << 5) | thirdChar; 


/* and the ‘rest’ (last four letters) */ 
memRest = 0; 
p = (char *) &memRest; 
while (len > 3) 

*pt+ = symbol [len-] ; 


rest = memRest; 
if (gSymbolIndex|[keyIndex] == 0) 
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} 


{ /* this is the first symbol with this key */ 

symbolP = (SymbolEntry *) gSymbolDataEnd; 
gSymbolIndex[keyIndex] = 

(ushort) (symbolP - 
gSymbolDataEnd += sizeof (SymbolEntry) ; 
symbolP->restOfSymbol = rest; 
symbolP->next = 0; 
symbolP->latestBlockNum = -1; 


else 
{ /* search the list for our last four letters */ 
symbolP = &gSymbols[gSymbolIndex[keyIndex]]; 
while ((symbolP->next != 0) && 
(symbolP->restOfSymbol != rest)) 
symbolP = symbolP->next; 
if (symbolP->restOfSymbol != rest) 
{ /* not found so add it */ 


symbolP->next = (SymbolEntry *) gSymbolDataEnd; 


symbolP = symbolP->next; 
gSymbolDataEnd += sizeof (SymbolEntry) ; 
symbolP->restOfSymbol = rest; 
symbolP->next = 0; 
symbolP->latestBlockNum = -1; 

} 


return symbolP; 


/* returns a pointer to a block in memory. If the 
block is not already in memory, it is loaded from disk. */ 
CachedBlock *getBlock(Header *dataP, short blockNum) 


CachedBlock *blockP; 
ParamBlockRec readPB; 


blockP = gBlockLocation[blockNun] ; 
if (blockP == 0) 
{ /* need to load it from disk */ 
if (gOldestBlockP->blockNum >= 0) 
gBlockLocation[gOldestBlockP->blockNum] = 0; 

gOldestBlockP->blockNum = blockNum; 
readPB.ioParam.ioCompletion = 0; 
readPB.ioParam.ioRefNum = gRefNum; 


readPB.ioParam.ioBuffer = (Ptr) gOldestBlockP->data; 


readPB.ioParam.ioReqCount = kBlockSize; 
readPB.ioParam.ioPosMode = fsFromStart 
| (1 << 5); / don’t cache */ 
readPB.ioParam.ioPosOffset = ((long) blockNum) 
* kBlockSize; 
PBRead(&readPB, true) ; 
gBlockLocation[blockNum] = gOldestBlockP; 


/* find the next oldest block */ 
if (gOldestBlockP == gLowestBlockP) 
gOldestBlockP = gHighestBlockP; 
else 
gOldestBlockP-; 
if (gOldestBlockP == gCurrentOutBlockP) 
if (gOldestBlockP == gLowestBlockP) 
gOldestBlockP = gHighestBlockP; 
else 
gOldestBlockP-; 
if ((gPB.ioParam.ioResult > 0) 
&& (((Ptr) gOldestBlockP->data) 
== gPB.ioParam.ioBuffer) ) 
if (gOldestBlockP == gLowestBlockP) 
gOldestBlockP = gHighestBlockP; 
else 
gOldestBlockP-; 
if (gOldestBlockP == gCurrentOutBlockP) 
if (gOldestBlockP == gLowestBlockP) 
gOldestBlockP = gHighestBlockP; 
else 





gOldestBlockP-; 
/* wait for read to complete */ 
while (readPB.ioParam.ioResult > 0) 


} 
return blockP; 
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gSymbols) ; 


void writeCurrentBlock(Header *dataP) 


{ 


CachedBlock *p; 


/* make sure any previous write is done */ 

while (gPB.ioParam.ioResult > 0) 

gPB.ioParam.ioRefNum = gRefNum; 

gPB.ioParam.ioBuffer = (Ptr) gCurrentOutBlockP->data:; 
gPB.ioParam.ioReqCount = kBlockSize; 
gPB.ioParam.ioPosMode = fsFromStart; 
gPB.ioParam.ioPosOffset = 

(long) gCurrentOutBlockP->blockNum) * kBlockSize; 
PBWrite(&gPB, true); 








/* find the next oldest block */ 

p = gOldestBlockP; 

if (gOldestBlockP == glowestBlockP) 
gOldestBlockP = gHighestBlockP; 

else 








gOldestBlockP-; 
if (gOldestBlockP == gCurrentOutBlockP) 
if (gOldestBlockP == gLowestBlockP) 
gOldestBlockP = gHighestBlockP; 
else 
gOldestBlockP-; 
gCurrentOutBlockP = p; 


void NewTrade(void *privateP, Trade trade) 


{ 


{ 


Header *dataP = (Header *) privateP; 
ulong seconds; 
TradeSummary *tradeP; 
SymbolEntry *symbolP; 


seconds = timeToSeconds(&trade.time) ; 


if (gCurrentEntryNum == kBlockEntries) 
{ /* current block is full, so write it out */ 
short curBlockNum = gCurrentOutBlockP->blockNum; 


writeCurrentBlock(dataP) ; 
eCurrentEntryNum = 0; 
if (gCurrentOutBlockP->blockNum >= 0) 
eBlockLocation[gCurrentOutBlockP->blockNum] = 0; 
eCurrentOutBlockP->blockNum = curBlockNum + 1; 
gBlockLocation[gCurrentOutBlockP->blockNum] = 
gCurrentOutBlockP; 
symbolP = findInsertSymbolEntry(dataP, trade.symbol) ; 
tradeP = &gCurrentOutBlockP->data[gCurrentEntryNum] ; 
tradeP->seconds = seconds; 
tradeP->price = trade.price; 
tradeP->totalShares = trade.numShares; 
if (symbolP->latestBlockNum >= 0) 
{ 
CachedBlock *blockP; 
TradeSummary *prevTradeP; 
ulong todaySeconds; 
todaySeconds = seconds - (seconds % kSecondsPerDay) ; 
blockP = getBlock(dataP, symbolP->latestBlockNum) ; 
prevTradeP = &blockP->data[symbolP->latestEntryNum] ; 
if (prevTradeP->seconds >= todaySeconds) 
tradeP->totalShares += prevTradeP->totalShares; 
} 
tradeP->prevBlockNum = symbolP->latestBlockNum; 
tradeP->prevEntryNum = symbolP->latestEntryNum; 
symbolP->latestBlockNum = gCurrentOutBlockP->blockNum; 
symbolP->latestEntryNum = gCurrentEntryNum; 
gCurrentEntryNumtt ; 


Fixed PriceIs(void *privateP, Str7 symbol, TimeStamp time) 


Header *dataP = (Header *) privateP; 
ulong seconds; 
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SymbolEntry *symbolP; 


seconds = timeToSeconds(&time) ; 
symbolP = findSymbolEntry(dataP, symbol) ; 


if (symbolP) 
 CachedBlock *blockP; 
TradeSummary *tradeP; 


/* look for the most recent trade that is before 
or on the requested time */ 
blockP = getBlock(dataP, symbolP->latestBlockNum) ; 
tradeP = &blockP->datalsymbolP->latestEntryNum] ; 
while (tradeP->seconds > seconds) 
( 
if (tradeP->prevBlockNum < 0) 
return 0; 
blockP = getBlock(dataP, tradeP->prevBlockNum) ; 
tradeP = &blockP->dataltradeP->prevEntryNum] ; 
} 


return tradeP->price; 


J 
else 
return 0; 


ulong VolumeIs(void *privateP, Str7 symbol, TimeStamp time) 


Header *dataP = (Header *) privateP; 
ulong seconds; 

SymbolEntry *symbolP; 

ulong todaySeconds; 


seconds = timeToSeconds(&time) ; 
todaySeconds = seconds - (seconds % kSecondsPerDay) ; 
symbolP = findSymbolEntry(dataP, symbol); 
if (symbolP) 
{ 
CachedBlock *blockP; 
TradeSummary *tradeP; 


/* look for the most recent trade that is before 
the requested time and on the same day */ 
blockP = getBlock(dataP, symbolP->latestBlockNum) ; 
tradeP = &blockP->data[symbolP->latestEntryNun] ; 
while (tradeP->seconds >= seconds) 
{ 
if (tradeP->prevBlockNum < 0) 
return 0; 
blockP = getBlock(dataP, tradeP->prevBlockNum) ; 
tradeP = &blockP->data[tradeP->prevEntryNun] ; 


if (tradeP->seconds < todaySeconds) 
return 0; 
else 
return tradeP->totalShares; 
} 
else 
return 0; 





To receive information 
on any products 
advertised in this issue, 


send your request 
via Internet: 
productinfo@xplain.com 
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UNIFORM 


RESOURCE 
Bole ype) it 





By John Kawakami, online@xplain.com. 








Spare your fingers and find this list online at: 
http://www.class.com/MacTech/URLs.html 


Internet-related Material 
Bolo http://bolo.ncsa.uiuc.edu/ 


Consensus http://www.consensus.com:8300 
CU-SeeMe http:/Awww.jungle.com/msattler/sci-tech/comp/CU-SeeMe/ 
DigiCash http:/Awww.digicash.com/ecash/ecash-home.htm| 


Info-Mac Searcher 
Internet Config 


http:/Awww.mid.net/INFO-MAC 
ftp://ftp.share.com/pub/internet-configuration/ 


InterNIC http:/Awww.internic.net/ 
ISDN page http://alumni.caltech.edu/~dank/isdn/ 
Peter Lewis ftp://amug.org/pub/peterlewis 
MacHTTP (see also WWW) 
Mailing List http:/Awww.biap.com/machttp/mailing_list.htm| 


Registry http://www.batnet.com/ape/machttp_talk/machttpservers.by.mac.html 


Extending MacHTTP 
http://www.uwtc.washington.edu/Computing/WWW/ExtendingMacHTTP. htm! 
MacWeb htto://galaxy.einet.net/EINet/MacWeb/MacWebHome.htm| 
Matthias Neeracher — http://err.ethz.ch/members/neeri.htm! 
OpenTransport/TCP gopher://seeding.apple.com 
Outland ftp://ftp.outland.com/ 
Portable Net. Graphics http://sunsite.unc.edu/~boutell/ong.htm| 
Eric Scouten (TCP) http://tampico.cso.uiuc.edu/~scouten/ 


SGML, Info http://www.sil.org/sgml/sgml.htm| 
C Parser ftp://ftp.jclark.com/pub/sgmls 
C++ Parser ftp://ftp.jclark.com/pub/sp/ 


WWW, Creating a Site 
http:/www.uwtc.washington.edu/Computing/WWW/Macintosh.htm| 
CGI demo/info http://charlotte.acns.nwu.edu/mailtools/ 

ftp://acns.nwu.edu/pub/jlnstuff/mailtools/ 

http://www.eit.com/web/www.guide/ 
nttp:/web66.coled.umn.edu/ 


Intro. to WWW 
Web66 
Non-Mac servers 


New Technologies 
AOCE ftp://ftp.andrew.cmu.edu/pub/aoce/ 
http://www.contrib.andrew.cmu.edu/usr/jbbt/aoce/aoce.html 
Apple, ftp ftp://ftp.info.apple.com 
Web interface to ftp http://www. info.apple.com/cgi-bin/lister-pl 
DTS http://www. info.apple.com/dev/dts.htm| 
Tech Notes 


see also http:/Awww.austin.apple.com 
Dylan http:/Awww.cambridge.apple.com/ 

see also ftp://cambridge.apple.com/pub/dylan 

see also http://legend.gwydion.cs.cmu.edu:8001/dylan 

see also news://comp:lang.dylan 

Mailing list archive _ ftp://cambridge.apple.com/pub/dylan/mail-archive/ 

Marlais ftp://ftp.cis.ufl.edu:/pub/src/Marlais 

http://www.cis.ufl.edu/~jnw/Marlais/ 

Mindy ftp://ftp.bdt.com//home/beard/Mindy-PPC.sit.bin 

Kaleida http:/Awww.kaleida.com/ 


OpenDoc/Bento/SOM = http:/Awww.cilabs.org/pub/cilabs/tech/ 
http://www.info.apple.com/dev/du/intro_to_opendoc/iod0_index.html 

OpenTransport/TCP gopher://seeding.apple.com 
ftp://seeding.apple.com/ess/public/mactcp/MacTCP_Dev_Kit 

PowerPC http://power.globalnews.com/ 

Taligent http:/Awww.taligent.com/ 
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http://www.w3.org/hypertext/WWW/Library/Status.html 


http://www.info.apple.com/dev/technotes/Main.html 


Other Programmer Resources 


Ada ttp://ftp.seas.gwu.edu/pub/ada 

Applescript ftp://gaea.kgs.ukans.edu/applescript 
Get1Resource http:/Awww..asel.udel.edu/~haynes/g1r.html 
Forth, MOPS http://www.netaxs.com/~jayfar/mops.html 


Robert Lentz 
htto:/Awww.astro.nwu.edu/lentz/mac/programming/home-prog.htm| 


Liso, MCL http://www.digitool.com/ 
General http://www.cs.rochester.edu/u/miller/alu.html| 
MacHack http://www.consensus.com:80/~machack/ 
see also http:/www.macgroup.com/MacHack.htm| 
MacTech ftp://ftp.netcom.com/pub/xp/xplain 
Matthias Neeracher — http://err.ethz.ch/members/neeri.htm| 
nick.c good for beginning Macintosh programmers! 


Francois Pottier 
also 
Digests archive 


http://www. pitt.edu/~nick/ 
http://acacia.ens.fr:8080/home/pottier/index.html 
news://comp.sys.mac.digest 
ftp://ftp.dartmouth.edu/pub/csmp-digest 


Jon Pugh (AppleScript) ftp://ftp.netcom.com/pub/jo/jonpugh/homepage.htm| 


Paul Robichaux 
Source code 
also UMich 


http:/www.iquest.com/~fairgate 
http:/www. info.apple.com/dev/devinfo/macsourcecode.html 
ftp://mac.archive.umich.edu/mac/development/source/ 


also M. Neeracher ftp://ftp.switch.ch/software/mac/sr/HTML/Welcome.htm| 


TCL stuff 


ftp://daemon.ncsa.uiuc.edu/TCL/ 


Vendors, Products and Miscellaneous 


Alpha (text editor) 


http:/Awww.cs.umd.edu/~keleher/alpha.htm| 


BBEdit ftp://ftp.netcom.com/pub/bb/bbsw 

Celestin ftp://ftp.teleport.com/vendors/cci/apprentice 

CIL http://www.cilabs.org/ 

Digitool http://www.digitool.com/ 

Dilbert http://www.unitedmedia.com/comics/dilbert 


Erogonomics Web 
EduPage newsletter 


http://tucker.mech.utah.edu/ 
mailto:listproc@educom.edu 
in the body of the message put: subscribe edupage your name 


Iconix http://www.biap.com/Iconix/ 
Just Some Guy http:/Awww.spies.com/greg/ 
MIND/MacDNS http://cybercronx.techwood.org 


Macintosh Vendor Directory 
Mac Netswitch 


http://rever.nmsu.edu/~elharo/faq/vendor.html 
http:/Awww.nd.edu/~dwalton1/ 


MacNosy ftp://ftp.netcom.com/pub/ma/macnosy 
Metrowerks http://www. iquest.com/~fairgate/cw/cw.html 
NeoLogic http://www.neologic.com/~neologic/ 
Newton http://newton.uiowa.edu/ 
QKS/Smalltalk http:/\www.aks.com 
QUED/M ftp://ttp.nisus-soft.com/pub/nisus 

see also http:/www.nisus-soft.com/~nisus 


QuickCam http://www. jungle.com/msattler/sci-tech/comp/hardware/quickcam.htm| 


Symantec ftp://devtools.symantec.com/macintosh/updaters/devtools 
TidBITS newsletter http:/Awww.dartmouth.edu/pages/TidBITS/TidBITS. htm| 
see also news://comp.sys.mac.digest 


to subscribe 
Time Tracker 


mailto:info@tidbits.com 
http://www.maui.com/~billm/ 


Continued on page 70 
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Developer Job Opportunities 


If you are a Macintosh developer, you should register with 
us! We have a database that enables us to let you know about 
job opportunities. When we are asked to do a search by a 
client company the database is the first place we go. There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide. 


Marketability Assessment - To get a specific feel for your 
marketability send a resumé via Email or call. You may also 
request a Resume Workbook & Career Planner. 


Discreet - We are very careful to protect the confidentiality 
of a currently employed developer. 


Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place- 
ment services and we are Mac fanatics. 


800-231-5920 | das @spi.com | Fax 713-496-0373 
Scientific Placement, Inc. 


MT, Box 19949, Houston, TX 77224 713-496-6100 Fax: 713-496-0373 

MT, Box 71, San Ramon, CA 94583 510-733-6168 Fax: 510-733-6057 

MT, Box 4270, Johnson City, TN 37602 615-854-9444 Fax: 615-854-9454 

MT, Kenmore Station, Box 15225, Boston, MA 02215 617-424-8372 Fax: 617-424-7158 





XG AppleLink: D1580; Compuserve: 71250,3001, eWorld: spi, AOL: davesmall 4 











YOU DONT HAVE TO LIVE IN THE URBAN JUNGLE 10 
~ DO WORLD-CLASS PROGRAMMING FOR EXCITING PRODUCTS! 






































Advantage Learning Systems, Inc. 
PO. Box 8036, Wisconsin Rapids, WI 54495-8036 


ADVANTAGE 


_ Learning Systems, Inc. 











MAC PROFESSIONALS 


Manpower Technical, a leader 
in the Technical Services industry, 
has current and upcoming 
contract openings for experienced 
MAC personnel with the following 
expertise: Software Development, 
Network Administrators, Desk 
Top Publishing, Help Desk, 


STF Technologies, Inc., the 
industry's leading faxing soft- 
ware manufacturer, is seeking 
applicants for Software 
Engineers with the following 
qualifications and experience: 





The Trattner Network 


The Trattner Network, a digital 
talent source, is looking for 
experienced Macintosh developers 
for a variety of consulting 
opportunities. Current projects 
include development in the areas 
of OpenDoc, Newton, Power PC, 
Metrowerks, PowerBook, Mac- 


Programming 
Geek? 


Rob Simms is 
a snow skiier 
extraordinaire | 









Applications Support, Technical 
Writers/Editors. 
Positions are in California and 
throughout North America. 
Interested persons are encour- 
aged to send their resume to: 
Manpower Technical 
ATTN: Dept. MT 
P.O. Box 2053 
Milwaukee, WI 53201 


(800) 558-6992 
Fax # (414) 332-0378 
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¢ Computer Science/ 
Engineering Degree 

e 3-4 years experience 

e Proficient in C, C++ 

e Ability to relocate 

e Experience in MacApp 
or AOCE 


JS TF TECHNOLOGIES, INC. 
P.O. Box 81 
Concordia, MO 64020 
AppleLink: D1870 
AOL: STFtech 
Compuserve: 74740,1244 





and a heck of $ 
a good App, 4D and many others. 
MacApp We have urgent needs for, 


programmer.” 


Whoopdedoos, 

bumpdebumps, and 
Grid Views. I find 

time to do them all." 


Miacxperts has openings for 
experienced C++ programmers. If 
you have what it takes, and the 
desire to achieve, call Kendall Tyler. 
at MacxXperts. 


Voice: 800-356-8040 Fax: 804-308-3847 — 


Internet: reeruiting @xperts.com 
~—Applelink: xperts ADL: MacXperts 










"Helicopters, | 





Software Developers, Hardware/ 


Firmware Engineers, QA/QC 
Professionals, MultiMedia Devel- 
opers, Project Coordinator/Man- 
ager, Network Professionals. 
Send, fax or link your resume: 


Attn: Nyla Miller 
170 State St., Ste. 240 
Los Altos, CA 94022 
Phone: (415) 949-9555 
Fax: (415) 949-1026 
Email: nmiller@tratnet.com 





THE CLASSIFIEDS 











By John Kawakami 








METROWERKS AND MICROSOFT COLLABORATE ON SOURCESAFE 


Metrowerks Inc (VSE, ME:MWK) and Microsoft Corp. 
(Nasdaq:MSFT) announced today their agreement for 
Metrowerks to co-develop and market the Macintosh version of 
SourceSafe, the cross-platform source-code management system 
by Microsoft. Metrowerks will develop and market two versions 
of SourceSafe for the Macintosh, one for the CodeWarrior/MPW 
environment, and one for other environments, both operate on 
68K and Power Macintoshes, and will work with SourceSafe for 
Windows 3.1, Windows-NT, Windows 95, and UNIX. 

Metrowerks SourceSafe for use with non-CodeWarrior 
development environments will be priced at $499 for a single- 
user license, the CodeWarrior version will be $299. 
Customers of earlier versions of SourceSafe will receive a 
special upgrade price. 

Metrowerks info: sales@metrowerks.com 





SYMANTEC C++ 8.0 
Symantec released the much anticipated C++ Version 8.0 for 
Power Macintosh. In addition to the powerful new features 
covered in this month’s review, the new Symantec Project 
Manager environment and Power Macintosh compiler operate 
on a 68k system. Of course, it won't let you debug PPC code 
on your Quadra. Symantec (800) 441-7234. 
The review is on page 74. 





VIP-C AND VIP-BASIC FoR RAPID DEVELOPMENT 
Mainstay VIP-C and VIP-BASIC are two visual application 
development systems for either 68000-based Macintosh or 
PowerPC Macintoshes. Coding can take place directly in the 
text editor, using standard Macintosh toolbox calls (and ANSI 
C libraries with VIP-C). Or, using the resource editors and 
higher-level functions, using the Dispatcher based application 
framework. The environment is completely interactive, with 
changes to resources and code effecting immediate feedback. 
Both come with a royalty-free, run-time module for the 
creation of stand-alone applications. VIP-C projects can also 
be compiled using hotlinks to Symantec Corporation’s Think C 
7.0, Apple Computer’s MPW, and Metrowerks’ Code Warrior. 

The upgrade to VIP-C 1.5 is now available to registered 
users for $50; suggested retail price of $495. The upgrade to 
VIP-BASIC 1.5 is $50 for registered users; suggested retail 
price of $295. For more information contact Lance Merker at 
Mainstay (805) 484-9400. 
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SNA GOES HEAD TO HEAD WITH KWIKSET, SCHLAGE... 


SNA’s BroadCast enables software publishers to electronically 
distribute their products to customers, letting potential 
customers try the software before buying it. The BroadCast 
Locker program compresses and encrypts the product into a 
single installer application. The installer will display instructions 
for ordering, the telephone number of the publisher's sales 
desk, and a unique control number. At the sales desk, using 
BroadCast KeyMaker, the publisher generates a unique key to 
unlock the installer. BroadCast can be used to distribute 
software on CD ROM, diskettes, or online. Pricing starts at $495 
for the license and $8.00 for the first 1,000 keys; prices drop in 
volume. For information call SNA (800) 628-6442. 





.«. AND QKS CHALLENGES BLACK AND DECKER 

QKS has announced VisualAgents, a consumer level, cross 
platform user environment based on the Agents Object System 
(AO/S). The VisualAgents component toolset and applications 
include a wide range of Internet tools and services, E-mail 
facilities, word processing and HyperMedia authoring facilities., 
all integrated through a built-in AO/S database engine to 
provide users with uniform data management, collaboration, 
and communication services. Third parties will be able to 
integrate AO/S objects into VisualAgents easily. VisualAgents is 
priced at $195, and a compatible Windows version is planned. 

DR/3 with a new integrated GUI Builder, View 
(Browser/Inspector) System, Simple Source Code Control 
system, and Documentation on both SmalltalkAgents and the 
underlying Agents Object System (AO/S), will ship a few weeks 
after WWDC. Starting with DR/4, SmalltalkAgents will include 
all the features of VisualAgents. 

QKS: info@qks.com 





KALEIDA DEBUTS, It’s (SORT OF) NETWISE! 

Kaleida Labs, Inc. is making available free copies of the Kaleida 
Media Player from its World Wide Web site. With ScriptX and the 
Kaleida Media Player, multimedia objects can be created by anyone, 
anywhere and distributed via the Internet for end-users to add to 
their applications. The player is installed as a helper application, 
and as each new, device-independent object is downloaded by 
your web browser or other internet client, the object is passed to 
the Player and added to the running ScriptX multimedia application. 
http://www. kaleida.com/ 
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By Neil Ticktin, Editor-in-Chief 








“Tr WASN’T SUPPOSED TO BE LIKE THIS” 


A relative newcomer to the Wonderful World of the Mac (after >20 
years in the industry!), I have just read your excellent magazine for 
the first time. My enjoyment came to an abrupt halt lin the January 
issue] on page 66, where Chris Espinosa aired a point of view as 
mistaken as it was bizarre. 

Espinosa argues that there is a computer “priesthood”, which 
loves complexity, and which, because it controls corporate 
computing, forces computers destined for home use to be more 
difficult to use than an elevator. Let me reassure him on the first 
point: the priesthood has not been an effective force in corporate 
computing for at least ten years; as soon as large numbers of people 
were talking to computers via a terminal, albeit a dumb one, then the 
days of the priest, interceding between the computer and the user, 
were numbered. What exists nowadays is an under-funded regular 
army trying to defend a major part of the corporation's assets — its 
data — from corruption by employees, and theft by intruders. The job 
is difficult and thankless, but essential to the corporation’s existence. 
Oh, and by the way, the complexity existed before the computer - 
most of us corporate computer types are constantly trying to simplify 
things, not make them more complicated! 

The second part of Espinosa’s argument is, if anything, even more 
specious than the first; the computer is not difficult to use because it 
has been designed for “the priesthood”, it is difficult to use because it 
does so many different things. A telephone is easy to use: you pick up 
the handset and you tap the number of the person you want to 
contact. Sure, but wait a moment: the last place I worked, there was a 
twenty-odd page booklet telling me how to transfer calls, set up 
hunting groups, record a voice-mail message, etc. etc. In fact, that 
damn phone was difficult to use, because of all the functionality, but 
only twelve buttons and no screen. Espinosa thinks that photo copiers 
are easy to use! Try making twenty copies of a 100 page single-sided 
document, when you want the output double-sided, and stapled 
together. Last time I tried that, I had every secretary in the building 
clustered around, giving me friendly, conflicting, and incorrect advice. 
My Mac is my typewriter, fax machine, remote terminal, filing system, 
billing system, pinball machine and slide projector. The amazing thing 
is that in every instance, the “machine” works in very much the same 
way, and, ... but then, surely, Espinosa can’t have forgotten the reason 
why the Mac was and is such a wonderful beast? 

Finally, as a European, I failed to understand how the Colt .45 
could be said to have had a beneficial effect on American society — 
how wild was the “Wild West” before every loony could blaze 
away at all and sundry with a hand gun? Is the gun lobby strong at 
Apple HQ? Is it safer in Redmond, WA? 

.but apart from that, I enjoyed the magazine! Best regards 


— Martin Jacobson 





SITTING ON My BOOKSHELF... 
Sitting on my bookshelf is a book published in 1976. It put forth the 
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remarkable idea that a good paradigm for an operating system (and 
the programs written for it) is that the programs should be small 
efficient tools that can be easily linked together through the operating 
system. The book, of course, is Software Tools, and the operating 
system is Unix. However, modern day Unix applications tend to be 
just the opposite — they are big, all encompassing, and actually quite 
inefficient if you take into account the changes in processor speed etc. 

A number of years ago, a gadfly named Hal Hardenburg (1 
may have misspelled his name) put out a newsletter named Dtack 
Grounded. Hal kept making the point that all else being equal, the 
customer will usually buy the product that is small, fast and 
efficient, and that the fact that “the hardware will eventually get 
faster” isn’t an excuse for large, slow software. 

It is not just nostalgia of an old fogey that makes me remember 
the above, but the series of articles in MacTech (on OLE and 
OpenDoc, on the proper language for people to be programming in, 
the article by Chris Espinosa “It Wasn’t Suppose to Be Like This”, and 
some recent software purchases I have made), OLE and OpenDoc 
seem to be harking back to the original goals of the Unix operating 
system. However, the descriptions of either technology is extremely 
complex, and based on the CD’s provided recently, are quite large 
also. Moreover, some software I recently purchased used one of these 
technologies. These programs are enormous, are total dogs when it 
comes to speed, and take up tremendous amounts of disk space — a 
lot of this appears to be associated with the new technology. Not 
surprisingly, as Mr. Hardenburg surmised years ago, the customer 
outcry has been deafening. Is this Unix redux — where the final 
product is opposite the stated goal? 

Many of the new products are being programmed in C++ or 
related programming languages, which we all know is good for us. 
Better code, fewer errors, faster development time. Just ask 
Borland, which a number of years ago switched exclusively to 
object technology. Since then there have been enormous delays in 
releasing any new product, and the company is in bad financial 
condition. On the Mac end, just look at the size of the programs 
that are being released now. Clearly better?!?! 

Even more instructive is an article that appeared in the ACM 
Transactions on Mathematical Software, Vol. 20, number 3, 1994, by 
AG. Buckley entitled “Conversion to FORTRAN 90: A Case Study.” 
The article describes the effort to reprogram one of his existing 
FORTRAN 77 algorithms to FORTRAN 90. Mr. Buckley gives a brief 
overview of the new features of FORTRAN 90. Not surprisingly, most 
of the new features are similar to features in C++ and other object 
oriented languages. Mr. Buckley is very enthusiastic about the 
conversion. However, there are several interesting tidbits hidden 
away in the article. The first is that while FORTRAN 90 has operators 
that work on arrays and FORTRAN 77 does not, and as his 
application has much to do with arrays and matrices this should 
reduce the code size, the FORTRAN 77 code is just over 6000 lines 
while the FORTRAN 90 code is over 9000 lines. 

The second tidbit is the timings. FORTRAN 90 code is a dog 
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compared to the FORTRAN 77! Mr. Buckley attributes the timings to 
the immaturity of the FORTRAN 90 compilers, but the FORTRAN 90 
code is much slower than a good FORTRAN 77 compiler. The hope 
is that better compilers will bring FORTRAN 90 so that it is within 
25% or so of FORTRAN 77. And of course, better hardware will 
make up for this loss of speed! All the nice abstraction properties of 
the new language make for a great routine in theory, but the fact 
remains that there are two algorithms, both of which accomplish the 
same purpose, and one is smaller and much faster than the other. 
Chris Espinosa made some good points about modern PCs 
and their operating systems - but he didn’t go far enough. The 
received theology is affecting applications as well. 
— koy Mendelssohn, Santa Cruz, CA 
Roy_Mendelssobn@ssp.nmfs.gov 





GETTING IT Orr My CHEST 


So Symantec have finally decided to launch a PowerPC 


compiler - wow! - and only 18 months too late... 

We've been using Symantec C (nee Think C) since 1986. At its 
inception it was a brilliant move up from the likes of Consulair. 
However, since Symantec took over, new versions have dried to a 
trickle and what has come out has been buggy and trivial. It took 
them over a year to get the C++ in version 6 even half-decent. 

Compare this with CodeWarrior. Great compilers, the greatest 
symbolic debugger ever and enthusiastic staff ready to council 
customers and implement their suggestions — and, most of all 
supplied on time. 

For those senile enough to remember entire systems written in 
machine code the reliance on others in the chain to the machine 
must cause worry — we are now far from our own masters. The 
introduction of any compiler moves us away from the machine 
(let’s say a foot) and dependent on the compiler for the correctness 
of the output. The introduction of object programming (say C++) 
introduces code, inserted by the compiler and interspersed with our 
code, to determine the relevant object hierarchy — that’s another 
couple of feet (three if your keeping count). 

Now objects come into their own when the modern programmer 
is faced with the ever-increasingly complex GUI, Scriptable 
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UserLand AutoWeb http://www. hotwired.com/Staff/userland/ 
The Well Connected Mac 
http://rever.nmsu.edu/~elharo/faq/Macintosh.html 


If you happen upon an interesting Internet resource, please send it 
to us at online@xplain.con. 


If you haven't gotten it already, check out the first release of the 


Kaleida media player. It zaps ScriptX over a network. 
http://www.kaleida.com/ 


PowerPC News is a free electronic magazine covering the 


PowerPC. 
http://power.globalnews.com/ 


Apple’s Web has been constantly active ever since it was 
introduced. Without a doubt, it is the best place to go for concise, 
interesting reading. 
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applications, diverse communications between other tasks and/or 
machines, etc. Here, we now rely on the Class Library, again supplied 
by the manufacturer, to remove a great deal of the pain that all this 
causes. That’s another twenty feet. (and I’m not even considering any 
aspect of the operating system here — which represents about half a 
mile). Some, like us, for their sins (or more likely perversion!) extend 
this so they work inside others environments like Quark or Photoshop 
- we're not considering that either. 

That fact is the a working program has to do just that — work, 
and that, as we have seen, is increasingly dependent on the 
reliance on the compiler manufacturer to supply timely, solid 
software. Even without the traumatic change (for some of us) to 
PowerMac, life in so volatile a period in computings’ history is 
difficult enough without a petulant compiler manufacturer that 
every Mac developer around the world has relied on for ten years. 

Well Symantec - it’s too bloody late. Your tardy notice that we 
were all screaming for an update for PowerMacs is just not good 
enough — the PowerMac has been out for 13 months! Every English 
and U.S. developer that I have spoken with has now moved to 
CodeWarrior — and they are not coming back. They’ve had enough 
of updates every two years, buggy compilers and no help at all. 
And after the C++ fiasco, how long will it be before the PowerMac 
compiler shows a hint of working... 

We had a 1.4mb Quark XTension that was part XTension, part 
application and related drivers that could only be compiled in one 
piece — so no way with any so called machine code converters. 
Since it relied on TCL 1.13 we had to upgrade to TCL 2.0 (1.14 if 
you look at the changes) and then convert across to CodeWarrior. 
This has cost in excess of £80,000 and halted product development 
for several months, financially reducing a small company to it’s 
kneecaps. We now have no Symantec products on any disks. 

If anybody wants to keep their business running get 
CodeWarrior and don’t look back. And MacTech, could we have a 
CodeWarrior Top Ten instead, specializing in the complex but 
powerful PowerPlant Class Library? ‘Cos I reckon that otherwise 
you will shortly be publishing ‘Thinks Only 10’... 

— R. Warren Davies, The Whizz Computing Company 





A little bit of beginner info about programming OpenDoc from the 
Developer University. 
http://www.info.apple.com/dev/du/intro_to_opendoc/iod0_ index.html 
The homepage for Apple Developers. This URL points to an online 
catalog not a reference manual. 
http://www.info.apple.com/dev/mdg/Home.html 

This is the index of everything on Apple’s servers. 
http://www.apple.com/documents/contents.html 

For programming tools, the ftp server is your best bet. It's 
constantly changing, and things are added every few weeks. They 
also mirror the ftp with faster web-and-cgi interface. These are 


equivalent services: 
ftp://ftp.info.apple.com 


http://www. info.apple.com/cgi-bin/lister-p| 


Several user maintained web pages have grown significantly, check 
out the following: 

http://www. pitt.edu/~nick/ 
http://www.jungle.com/msattler/sci- 
tech/comp/hardware/quickcam.html 
http://rever.nmsu.edu/~elharo/faq/Macintosh.html 
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E-mail, Fax, write, or call us. You may use your VISA, 
MasterCard or American Express; or you may send check 
or money order (in US funds only): 

MacTech Magazine, P.O. Box 250055, Los Angeles, CA 
90025-9555. 

Voice: 310/575-4343 © Fax: 310/575-0925 


If you are an e-mail user, you can place orders or contact 
Customer service at: 

¢ AppleLink: MT.CUSTSVC 

* CompuServe: 71333,1063 

e Internet: custservice@xplain.com 

¢ America Online: MT CUSTSVC 
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SUBSCRIPTIONS 

US magazine with domestic source code disk: $124 for 
12 issues 

Canadian magazine with Canadian source code disk: : 
$136 for 12 issues 

International magazine with international source code 
disk: $194 for 12 issues 


CD-ROM 

MacTech CD-ROM, Volumes LIX: Includes over 1100 
articles from all 103 issues (1984-1993) of MacTech 
Magazine (formerly MacTutor). All article text and source 
code. Now in THINK Reference format. The CD includes 
Symantec's THINK™ Reference 2.0, working applications 
with full documentation, product demos for developers and 
more. See advertisement, this issue: $199. Upgrades $69, e- 
mail, call or write for info. 


BOOKS 

The Best of MacTutor, Volume 1: Sold Out 

The Complete MacTutor, Volume 2: Sold Out 

The Essential MacTutor, Volume 3: $19.95 

The Definitive MacTutor, Volume 4: $24.95 

The Best of MacTutor, Volume 5: $34.95 

Best of MacTutor Collection, Volumes 3 - 5: $69 

Best of MacTutor, Volumes 6, 7, 8 & 9: Not available 


DISKS 
Source Code Disks: $8 each 
Topical Index (1984-1991) on disk: $5 


MAGAZINE BACK ISSUES 
Volumes 3, 4, 5, 6, 7, 8,9 and 10: $5 each (subject to 
availability) 


California residents include 8.25% sales tax on al] 
software, disks and books. 


Allow up to 2 weeks for standard domestic orders, more time 
for international orders. 


PLEASE NOTE 

Source code disks and journals from MacTech Magazine are 
licensed to the purchaser for private use only and are not to be 
copied for commercial gain. However, the code contained 
therein may be included, if properly acknowledged, in 
commercial products at no additional charge. All prices are 
subject to change without notice. 
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MacTech Magazine is your exclusive source 
for these specific products: 


Ad Lib 2.0 The premier MacApp 3.0 compatible 
ViewEdit replacement. A powerful user-interface 
editing tool to build views for MacApp 3.0 and 3.1, 
Ad Lib allows subclassing of all of MacApp's view 
Classes including adorners, behaviors, and drawing 
environments. String and text style resources are 
managed automatically. Alternate display methods, 
such as a view hierarchy window, allow easy 
examination of complex view structures. Ad Lib 
includes source code for MacApp extensions that are 
Supported by the editor — buttons can be activated by 
keystrokes, behaviors can be attached to the 
application object, and general purpose behaviors 
Can be configured to perform a number of useful 
functions. Run mode allows the user to try out the 
views as they will work in an application. Templates 
can be created to add additional data fields to view 
Classes. Editing palettes provide fast and easy editing 
of common objects and attributes. Works with ACI's 
Object Master (version 2.0 and later) to navigate a 
project's user interface source code. $195 


FrameWorks Magazine: $8/issue, 
Subject to availability. 


FrameWorks Source Code 
Disk: $10/issue, subject to availability. 


NEW! Five Years of Objects CD-ROM: 
FrameWorks archives and source code 
irom April 1991 to January 1993, plus selected object- 
Oriented publicly available software and demos. $95 


MADACON '93 CD-ROM: The highlights of 
MADACON '93, including Mike Potel on Pink. 
Bedrock, MacApp, OODLs, and more. Slides, 
articles, demos, audio, and QuickTime. $95 


NEW! MAScript 1.2 adds support for 
AppleScript to your MacApp 3.0.1 and 


3.1 based applications. Make your application 
scriptable and recordable by building on a tried and 
tested framework for object model support. MAScript 
dispatches Apple events to the appropriate objects, 
creates object specifiers, and makes framework 
Objects like windows and documents scriptable and 
recordable. Sample application shows you how to 
begin adding support for scripting and recording. 
MAScript includes complete source code. Install 
MAScript by modifying one MacApp source file, then 
adding another to your project. Future versions of 
MacApp will incorporate MAScript, so MAScript 
support you add now will work in the future. $199 


The Mjsiner BETA System is a software 
development environment supporting object-oriented 
Programming in the BETA programming language. 
BETA is uniquely expressive and orthogonal. BETA 
unifies just about every abstraction mechanism — 
including class, procedure, function, coroutine. 
process and exception — into the ultimate abstraction 





mechanism: the pattern. BETA includes: general 
block structure, strong typing, whole/part objects. 
The compiler: binary code generation, automatic 
garbage collection, separate compilation, interface to 
C, Pascal, and assembler. The system: persistent 
objects, basic libraries with containers classes, 
platform-independent GUI application frameworks on 
Unix, Mac and Windows NT, metaprogramming 
system. The tools available on Unix: the hyper 
Structure editor supporting syntax directed editing, 
browsing, etc., and the source code debugger are 
currently being ported to the Macintosh system. The 
Mjginer BETA System for Macintosh requires MPW 
(basic set) 3.2 or later. Package containing compiler, 
basic libraries, persistent store, GUI framework, and 
comprehensive documentation. (Other packages are 
also available) $295 


More Savvy includes all Savvy 

features plus Apple event support for all 
sub-classes of TEventHandler with extensive view 
support. Apple event support for text includes text 
attributes and sub-range specification. Recordability 
supports additional actions, and coercion includes 
additional types. Additional client and server Apple 
events. $450 


| NEW Version! | Savvy 1.1 OSA support 
includes attachability, 
recordability, scriptability, coercion, in addition to 
Script execution, idling and i/o. Apple event support 
includes complex object specifiers, synchronous/ 
asynchronous Apple event handling, and Apple 
event transactions for clients and servers. The Core 
Suite of Apple event objects is supported including 
the application, documents, windows, and files. 
Documentation includes technology overview, 
cookbook, and sample code. $250 Savvy now 
supports MPW 3.1, 3.11 and continues to support 
3.01, as well aS supporting Metrowerks Code 
Warrior. This month only, special offer — Al 
Savvy versions include free copy of Savy QuickTime! 


NEW! Savvy DataBase Requires Savvy, 
More Savvy, or Super Savvy. $250 


NEW! Savvy QuickTime Requires Savvy, 
More Savvy, or Super Savvy. Includes 
QuickTime, Apple event and view template support. 
Movies come out of the box ready to play, edit, and 
react to Apple events. They can be included in any 
view structure, including templates, and are 
displayed in the scrap view. Movie controls include 
volume, play rate, looping mode, display style, and 
othercharacteristics. $250 


NEW! Super Savvy includes all More Sawy 
features plus compile, edit, and record 
scripts using built in script editor. View template 
editors, like Ad Lib, can attach scripts to view 
objects and modified scripts are saved with the 
document. Script action behavior allow quick access 
for executing and editing scripts attached to views. 
Text to object specifier coercion plus more. $700 


MacTech Magazine is your exclusive source 
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for available back issues of SFA's magazine, 
source code disks and assorted CD's. Call for 
more info and pricing. 


BOOKS 


Adobe Premiere for Macintosh: 

Classroom in a Book, Second 
Edition by Adobe Press. This is the updated edition of 
the official Adobe training workbook! Covering all the 
essential features of this video editing software, this 
book/CD-ROM set features twenty tutorial lessons to 
guide teachers and students through the magic of 
Macintosh movie-making. @ CD-ROM includes 
QuickTime movies, electronic images, and frames needed 
for the workshop lessons in the book. ¢ Detailed yet 
easy-to — follow steps to creating multimedia 
presentations, animation, and videos. © Contains the 
latest information on filters, audio, Superimposed clips, 
advanced editing, and more $40-05 $44.95 


America Online For Dummies™ by 

John Kaufeld. "Driver's Education" for this 
wildly popular on-line service — covering everything from 
the main menu to the mail groups for Windows, DOS, and 
Mac platforms. Includes a coupon for free usage time on 
AOL for.first-time users. 49-99 $17.95 


C For Dummies,™ Volume 1 by Dan 

Goodwin. Finally! A hands-on, step-by-step 
tutorial for learning the essentials of programming in C. 
$40-05 $17.95 


C++ For Dummies™ by Stephen R. Davis 

is the all-in-one reference that gets you 
comfortable with object-oriented methods and up and 
running doing C++ programming! $49-06 $17.95 


— The Complete AppleScript® Hand- 
book by Danny Goodman isa self-contained 

to customizing and enhancing the Macintosh 
ane The disk contains AppleScript 1.1 Runtime, 
Chang Labs TableServer, and useful, ready-to-run scripts. It 
also shows the Mac user how to automate many processes 
—no programming experience necessary. $8608 $31.50 


NEW! The Complete HyperCard® 2.2 
Handbook Fourth Edition by Danny 
Goodman is the biggest-selling Mac book — new revised 
and updated for version 2.2. It shows how to build working 
applications using the latest version of HyperCard and 
covers text, painting tools, extension commands (XCMDs), 
scripting in HyperTalk, and more. $3608 $31.50 


NEW! CompuServe For Dummies™ by 
Wallace Wang Find out how to shop, play 
games, join forums, get the latest news, do research, and 
more on this popular on-line service. $49-05 $17.95 


NEW! | Danny Goodman's AppleScript Hand- 
book Second Edition by Danny Goodman is a 
self-contained kit shows the reader how to customize and 
extend the capabilities of any Macintosh computer — no 
programming experience needed! This enhanced and 
expanded edition of The Complete AppleScript Handbook 
focuses on putting AppleScript to work in all sorts of 
practical situations. In addition, Danny Goodman's 
AppleScript Handbook, Second Edition shows you how to 
apply the same principles to other popular scripting systems, 
such as Userland Frontier and QuickKeys. Shows readers 
how to use scripts to enhance the Macintosh environment, 
automate many processes, link data between applications, 
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and much more. This book provides a wealth of all-new 
examples showing how to integrate AppleScript with the 
Finder, spreadsheets, desktop publishing programs, 
graphics applications, databases, telecommunications 
programs, utilities, and HyperCard. The accompanying 3 
1/2" disk is jam-packed with over $100 worth of software, 
including AppleScript 1.1, valuable utilities, and powerful, 
ready-to-use scripts. $80-08 $35.00 


NEW!) Danny Goodman's Macintosh® Hand- 
book Featuring System 7by Danny 
Goodman with Richard Saul Wurman. This user friendly 
design includes a unique four-color design and exploded 
diagrams. It includes over 100 spreads break down and clarify 
Mac problems and includes insider's tips. $29:95 $26.95 


NEW! The Delphi Internet Start-Up Guide 
Your Personal Guide to Delphi Internet 
Services by Steve Lambert and Walt Howe. This book 
showcases the new graphical Delphi Internet online service. 
There are over 20 million Internet users worldwide, and 
Delphi — with over 600 local access numbers across the 
country — is one of the cheapest and most popular 
commercial services to provide full Internet access. And 
now, with Delphi's new graphical front end, anyone with a 
computer, a modem, and a phone line can get on the 
Internet. The accompanying CD-ROM contains Delphi's 
new, easy-to-use, graphical interface software for effortless 
Internet navigation, popular games, and other Internet tools. 
The book includes a hands-on, guided tour of Delphi's 
hottest new services and resources. As well as a special 
offer from Delphi Internet Services that gives the reader 
immediate access to the Internet, five hours of free online 
time, and exclusive special discounts. $40-08 $36.00 


The Elements of E-Mail Style by Brent Heslop 
and David Angell. Learn the rules of the road in the e-mail 
age. Concise, easy-to-use format explaining essential e- 
mail guidelines and rules. It covers style, tone, 
typography, formatting, politics and etiquette. It also 
outlines basic rules of composition within the special 
context of writing e-mail and includes samples and 
templates for writing specific types of e-mail 
correspondence. 208 pages. $4495 $13.45 


E-Mail Essentials by Ed Tittel & Margaret Robbins is 
a hands-on guide to the basics of e-mail, the ubiquitous 
networks communication system. The book is suitable for 
both the casual e-mailer and the networking professional, 
as it covers everything from the installation of e-mail to the 
maintenance and management of e-mail hubs and 
message servers. The books explains the fundamental 
concepts and technologies of electronic mail, featuring 
chapters on Lotus applications and CompuServe, as well 
as information on upgrading, automation, message-based 
applications, and user training. E-mail Essentials is a step- 
by-step, jargon-free guide that will enable the e-mail user 
to get the most out of the communication potentials of 
networking. 250 pp. $2495 $22.45 


eeWorld: The Official Guide for 

Macintosh Users by Cary Lu & John 
Milligan. Discover the next generation of online services 
— Apple's eWorld. Certain to be a bestseller, this 
authorized guide to contains the exclusive Apple software 
needed to connect to eWorld. It also provides a road map 
of eWorld and all of its features, and is the first and best 
book on this exciting new service. @ Covers every aspect 
of eWorld, the next generation of online services. @ 
Everything users need to get connected and get the most 
out of eWorld. ¢ The only official Apple book and 


software for accessing eWorld $20-06 $26.95 


NEW! Graphic Gems V Edited by Alan W. Paeth 
is Graphic Gems V is the newest volume in The 
Graphic Gems Series. It is intended to provide the graphics 
community with a set of practical tools for implementing 
new ideas and techniques, and to offer working solutions to 
real programming problems. These tools are written by a 
wide variety of graphics programmers from industry, 
academia, and research. The books in this series have 
become essential, time-saving tools for many 
programmers. It is the latest collection of graphics tips in 
The Graphic Gems Series written by the leading 
programmers in the field. It contains about 50 new gems 
displaying the most recent and innovative techniques in 
graphics programming. Also included is new gems in 
ellipses, splines, Bezier curves, and ray tracing. Includes a 
disk which contains source code from all five volumes and 
is available in both IBM and Macintosh versions. 
CONTENTS: Algebra and Arithmetic. Computational 
Geometry. Modeling and Transformation. Curves and 
Surfaces. Ray Tracing and Radiosity. Har and Image 
Processing. Utilities. Available late June. $49-06 $44.95 


NEW! Guide to Macintosh System 7.5 by 
Don Crabb. Written by an industry expert, this 
is the first thorough book on the new and improved 
Macintosh operating system. Readers will learn all the 
highlights of the new System, including how to work 
efficiently with applications. Intuitive, task-oriented 
approach teaches topics the way users think, not the way 
the machine thinks. © Covers all the new features of 7.5 
and 7.5 Pro, including PowerTalk, PC Exchange, and 
MacTCP. ¢ Written by a world-renowned Mac expert 
$26-08 $22.50 


How To Write Macintosh Software by Scott 
Knaster is a great source for understanding Macintosh 
programming techniques. Drawing from his years of 
experience working with programmers, Scott explains the 
mysteries and myths of Macintosh programming with wit 
and humor. The third edition, fully revised and updated, 
covers System 7 and 32-bit developments, and explores 
such topics as how and where things are stored in 
memory; what things in memory can be moved around 
and when they may be moved; how to debug your 
applications with MacsBug; how to examine your 
program’s code to learn precisely what's going on when it 
runs. 448 pgs. $28-06 $26.05 


NEW! HyperTalk® 2.2: The Book Second 
Edition by Dan Winkler, Scot Kamins, and — 
Jeanne DeVoto is the most complete, authoritative source 
on HyperTalk 2.2 programming and troubleshooting. It 
covers each language element of HyperTalk 2.2 (including 
the odd quirk or bug). $8668 $31.50 


NEW! Inside the PowerPC by Tom Badgett 
The PowerPC, which can run both PC and 
Macintosh software, signals a new trend in personal 
computers — and Inside The PowerPC covers this new 
technology as no other book. Whereas the Pentium 
represents the end of a long line of development, the 
PowerPC represents the beginning of a new wave of personal 
computers — and, because of its high speed and low power 
consumption, it is especially suitable for the hot selling 
portable computers. It covers the PowerPC in both its Mac- 
centric and PC-centric versions (either of which can run the 
other's software in emulation) and shows the reader how to 
get the most out of a PowerPC-based machine, including 
how to work with floppy disks, hard drives, memory, video, 
printers, networking, modems, and multimedia. Also shown 
is how to upgrade suitable machines to the PowerPC, and 
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explains in easily understood terms the design and 
performance of the PowerPC. $3900 $27.00 


The Instant Internet Guide by Brent Heslop and 
David Angell. An Internet jump-start — how to access, use 
and navigate global networks. The Instant Internet Guide 
equips readers with the tools needed to travel the electronic 
world. The book highlights the most important sources of 
Internet news and information and explains how to access 
information on remote systems. It outlines how to use 
essential Internet utilities and programs and includes a 
primer on UNIX for the Internet. 224 pages $44.05 $13.45 


NEW! The Internet by Paul Hoffman gives the 
straight scoop on the Net with the elegant, 
entertaining 4-color companion to the PBS special "The 
Internet Show." Color photos and illustrations explain 
Internet key features, its history, and trivia. Covers the 
basics and also a multitude of Internet Information Services 
and extensive lists of Internet sites. $24.09 $22.50 


NEW! The Internet, Deluxe Edition by 
Paul Hoffman. All of the brilliance of The 
Internet plus the hot NetManage Internet Chameleon 
software! This bundled Deluxe Edition includes 
everything you need to surf the Net! Fully automated, 
NetManage has put together 3 disks filled with Internet 
tools, service providers, applications, and more — an 
unbelievable value! $34.89 $31.50 


The Internet For Macs For Dummies” 

by Charles Seiter. Now novice Mac users have 
an Internet guide written especially for them — in the easy 
...For Dummies™ style they love. $49-99 $17.95 


The Internet For Dummies” 2nd 
Edition by John Levine and Carol Baroudi. 
Surf the net with ease using the up-to-the-minute new 
edition of the #1 bestselling Internet reference — now with 
friendly help on connecting to the Internet. $49-99 $17.99 


The Internet For Dummies” Quick 

Reference by John Levine. This fact-filled 
quick reference provides plain English explanations of 
Internet terms and basics. Cross-referenced to The 
Internet For Dummies. $8-95 $8.05 


The Internet For Macs For Dummies” 

Starter Kit by Charles Seiter. Access and 
navigate the Net like a pro the fun and easy way with this all- 
inclusive Starter Kit for Mac users. Kit includes a special edition 
of the bestselling The Internet For Macs For Dummies™, plus 
two disks featuring The Pipeline and TCP/Connect II® 
Extended software with: E-Mail, UseNet News Reader, FTP, 
Telnet, Gopher, and more! $29-99 $26.99 


NEW! The 1994 Internet White Pages by 

seth Godin & James S. McBride is the one and 
only complete alphabetical directory of people on the 
Internet. $20-95 $26.95 


Internet Power Tools by John Ross is 

designed for intermediate PC users, Internet 
Power Tools is a complete book/disk package that allows 
access to the world's largest network — the Internet — with 
the same ease as one uses Windows. The detailed 
instructions allow readers to find their way around the 
Internet fast and covers e-mail, file transfers, remote logon, 
on-line directories, and more. The accompanying disk is 
packed with powerful utilities, including Cello, PC Eudora, 
and Panda — easy-to-use graphical user interfaces (GUI) 
that obviate the need for the obscure Unix line commands 
that everyone else must learn. It also provides access to 
even more software via Random House's Internet FTP site 
and shows how to connect to the Internet via a network 
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connection or dial-in. $4000 $36.00 


NEW! Internet SECRETS by John Levine & 
Carol Baroudi gives the most from the Net with 
this performance-oriented book — for Windows, UNIX, DOS, 
and Mac Internet users who know how to get connected but 
want to optimize their connections. $39-89 $35.99 


Learn C on the Macintosh by Dave Mark. This 
self-teaching book/disk package gives you everything you 
need to begin programming on the Macintosh. Learn to 
write, edit, compile, and run your first C programs 
through a series of over 25 projects that build on one 
another. The book comes with THIN C — a customized 
version of Symantec's THINK C, the leading programming 
environment for Macintosh. 464 pages, Book/disk: 
$408 $31.45 


Learn C++ on the Macintosh by Dave Mark. After 
a brief refresher course in C, Learn C++ introduces the 
basic syntax of C++ and object programming. Then you'll 
learn how to write, edit, and compile your first C++ 
programs through a series of programming projects that 
build on one another as new concepts are introduced. Key 
C++ concepts such as derived classes, operator 
Overloading, and iostream functions are all covered in 
Dave's easy-to-follow approach. Includes a special version 
of Symantec C++ for Macintosh. Book/disk package with 
3.5° 800K Macintosh disk. 400 pages, $36-95 $33.26 


Macintosh € Programming Primer Volume 1, 
Second Edition, Inside the Toolbox Using 
THINK C by Dave Mark and Cartwright Reed. This new 
edition of this Macintosh programming bestseller is updated 
to include recent changes in Macintosh technology, 
including System 7, new versions of THINK C and ResEdit, 
and new Macintosh machines. Readers will learn how to use 
the resources, Macintosh Toolbox and interface to create 
Stand-alone applications. 672 pages, $26-05 $24.25 


Macintosh C Programming Primer Volume 
Il, Mastering the Toolbox Using THINK C by 
Dave Mark. Volume II picks up where Volume | leaves off, 
covering more advanced topics such as: Color 
QuickDraw, THINK Class Library, TextEdit, and the 
Memory Manager: 528 pgs. $26-05 $24.25 


Macintosh® Crash Course by Glenn 

Brown shows Macintosh power users what to 
do when things go wrong with their system. Macintosh 
Crash Course shows readers how to overcome Macintosh 
system crashes, system lock-ups, and various, frustrating 
and cryptic error messages they regularly encounter. It 
includes a CD-ROM with shareware and freeware to help 
the user diagnose and repair system failures. Includes up- 
to date coverage through Macintosh System 7.5, Managing 
memory, Hardware diagnostics, File recovery, PowerBook 
problems, PowerPC problems, network utilities, hard drive 
repair utilities, SCS! problems, conflicts and solutions and 
File synchronization and utilities. $29-05 $26.95 


NEW! Macintosh First Aid Kit by Erica 
Kerwien. The ultimate desktop first aid kit for 
all kinds of Macintosh emergencies. Designed for all 
users, this book keeps essential information close by! 
Organized for quick diagnosis and easy solutions. 
Focuses on software and system maladies. ¢ Disk 
features professional-strength tools, including a special 
version of Fifth Generation's Public Utilities for the Mac 
and Casady & Greene's Crash Barrier $49-05 $17.95 


Macintosh Pascal Programming Primer 
Volume I, Inside the Toolbox Using THINK 
Pascal by Dave Mark and Cartwright Reed. This tutorial 
shows programmers new to the Macintosh how to use the 
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Toolbox, resources, and the Macintosh interface to crea 
Stand-alone applications with Symantec’s THINK Pascal. 
944 pages $26-95 $24.25 


Macintosh Programming Techniques by Dan 
sydow (Series Editor: Tony Meadow). This tutorial and 
handbook provides a thorough foundation in the special 
techniques of Macintosh programming for experienced 
Macintosh programmers as well as those making the 
transition from DOS, Windows, VAX or UNIX. Emphasizes 
programming techniques over syntax for better code, 
regardless of language. Guides the reader through Macintosh 
memory management, QuickDraw, events and more, using 
sample program in C++. Disk includes an interactive tutorial, 
plus reusable C++ code. $8495 $31.95 


NEW! Mac Programming for Dummies” by 
Dan Parks Sydow takes the intimidation and 


work out of writing Mac programs. $49-95 $17.95 


Mac Screamer The Ultimate 

Macintosh® Supercharging Kit by Jan 
Harrington covers 30 Macintosh models, including the 
Classics, LCs, PowerBooks, and Quadras and gives 
software solutions and hardware tips to accelerate Mac 
performance. It lets readers in on do-it-yourself tips that can 
save them over 25% on upgrade costs. $35-00 $31.50 


NEW! Macworld Ultimate Mac Program- 
ming by Dave Mark Bestselling Mac 
programming author Dave Mark reveals the secrets of 
Mac programming and presents important, timesaving 
techniques. $89-05 $35.95 


NEW! MORE Internet For Dummies” by 
John Levine & Margaret Levine Young. The 
expanded guide full of great Internet tips for all those 
users who want to know where to go and what to do once 
connected. $49:95 $17.95 


Mosaic For Dummies’, Windows 

Edition by David Angell & Brent Helsop. 
Learn to use Mosaic with the only book that explains the 
most popular viewer of the World Wide Web in plain 
English. Covers the popular Windows version of Mosaic. 
$49-09 $17.99 


Multimedia Authoring: Building and 
Developing Documents by Scott Fisher addresses 
the concerns that face anyone trying to create multimedia 
documents. It offers specific advice on when to use 
different kinds of information architecture, discusses the 
human-factors concepts that determine how readers use 
and retain information, and them applies these findings to 
multimedia documents, covering the high-level issues 
concerning planners and authors of multimedia 
documents as well as those involved in evaluating or 
purchasing multimedia platforms. Includes one 3.5" high- 
density disk. $8495 $31.45 


Multimedia Starter Kit for Macin- 

tosh by Michael D. Murie. This hands-on 
book offers the latest and greatest in multimedia for the 
Mac! Readers learn how to design their own multimedia 
projects step by step, then try it themselves with the 
demos, graphics, clips, and sample projects on the CD- 
ROM! © CD-ROM contains QuickTime, sound and 
graphics clips and utilities, sample projects, and more. e 
How to choose and use a variety of Macintosh multimedia 
tools and presentation environments. © Includes demos 
of Adobe Illustrator, Premiere, Heizer Software programs, 
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and more $30-08 $27.00 


Net Chat™ by Michael Wolff & Co. There are 

an estimated 35 million people online and 
most of them spend time chatting on the Net. Net Chat is the 
first comprehensive, discriminating guide devoted to the 
vast world of online interpersonal communications. 
Following the successful format of the ever popular Net 
Guide, Net Chat is designed for easy access, featuring an 
attractive layout, informative illustrations, and thousands of 
choices. It is encyclopedic in scope — covers "chat" groups 
on the Internet, all the major commercial services (including 
CompuServe, Prodigy, and America Online), and hundreds 
of bulletin boards. It features a map of salons and meeting 
places in Cyberspace, where people stop to chat about 
politics, lifestyle, music, dating, sex, fantasy, health, family, 
and just about everything imaginable! The entries include 
one- and two-page spreads that describe the featured topic, 
and provide easy-access instructions, complete listings, and 
visual images from the Net. For use with all computer 
platforms — PCs, Macs, workstations. $49-68 $17.00 


NEW! PowerBook” The Digital Nomad's 
Guide by Andrew Gore and Mitch Ratcliffe. 
$2406 $21.60 


Power Macintosh Programming 

Starter Kit by Tom Thompson. This is the 
first tutorial/reference for programmers who want to enter 
the new world of the PowerPC chips. Users find all the 
details on the new microprocessors, the new RISC 
architecture, and how to write native code and emulation 
operations to create their own software for the Macintosh 
PowerPC. @ CD-ROM includes a unique compiler for 
writing code easily. @ The all-in-one book that gets 
programmers the information and tools they need. © 
Programming examples reinforce explanations of code 
and programming tools $89-08 $35.10 


Programming for System 7 by Gary Little and Tim 
Swihart, is a hands-on guide to creating applications for 
System 7. It describes the new features and functions of 
the operating system in detail. Topics covered include file 
operations, cooperative multitasking, Balloon Help, Apple 
events, and the File Manager. Numerous working C code 
examples show programmers how to take advantage of 
each of these features and use them in developing their 
applications. 384 pages. $26-96 $24.25 


Programming for the Newton Software 
Development with NewtonScript by Julie 
McKeehan and Neil Rhodes. Foreword by Walter R. 
Smith. Programming for the Newton: Software 
Development with NewtonScript is an indispensable tool 
for Newton programmers. Readers will learn how to 
develop software for the Newton on the Macintosh from 
people that developed the course on programming the 
Newton for Apple Computer. The enclosed 3.5" disk 
contains a sample Newton application from the books, as 
well as demonstration version of Newton Toolkit (NTK), 
Apple Computers complete development environment for 
the Newtons. A Publication of AP Professional May 1994, 
Paperback, 393 pp. $20-95 $26.95 


Programming in Symantec C++ for the 
Macintosh by Judy May and John Whittle. This book 
will introduce you to object-oriented programming, the C-++ 
language, and of course Symantec C++ for the Macintosh. 
You don’t have to be a programmer, or even know anything 
about programming to benefit from this book. Programming 
in Symantec C++ for the Macintosh covers everything from 
the basics to advanced features of Symantec C++. If you are 
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a Think C or Zortech C++ programmer who wants to learn 
more about object-oriented programming or what's different 
about Symantec C++, there are chapters specifically for you. 
Includes helpful examples of C++ code that illustrate object- 
oriented programs. $20-05 $26.95 


NEW!| Programming Primer For The Macin- 

tosh® Volume 1 by John Whittle and Judy 
May. This book provides an introduction to Macintosh 
programming, using C++ as the example language, and 
provides realistic, easy to follow, programming examples 
designed to work with either Symantec® C++ or 
Metrowerks® CodeWarrior”. Also includes one 3.5" disk 
with source code for the programming examples, along 
with numerous, useful, public domain utilities to use with 
each compiler. $3405 $34.15 


QuickTime Starter Kit for Macin- 

tosh by Robert A. Lettieri & Judith Stern. 
This is the ultimate package for getting productive and 
having fun with Macintosh movie-making. Easy steps 
and valuable software help readers play, make, and edit 
QuickTime movies. @ CD-ROM includes QuickTime 
tools, movie clips, shareware, and demos of Premiere and 
other programs. © Written by members of the respected 
Berkeley Macintosh User Group. Tips on the best ways 
to bring live-action video to Mac multimedia $46-00 
$40.50 


NEW!) The ResEdit All Night Diner by David 
Ciskowski. An idea-filled menu and 
introduction to the joys of customizing software — and 
adding personality to the Mac with ResEdit! © Shows 
readers how to customize default icons, the text of menus 
and dialog boxes, cursors, pointers, and more. @ 
Provides specific recipes for doing creative things with 
ResEdit — plus how to avoid problems. ¢ Disk features 
ResEdit program, plus lots of sample resources $2406 
$22.45 


ResEdit™ Complete, Second Edition by Peter 
Alley and Carolyn Strange. With ResEdit, Macintosh 
programmers can customize every aspect of their interface 
form creating screen backgrounds and icons to 
customizing menus and dialog boxes. 608 pages. 
Book/disk package. $84.05 $31.45 


Sad Macs, Bombs, Disasters and What to Do 
About Them by Ted Landau comes to the rescue with your 
Macintosh problems. From fractious fonts to the ominous 
Sad Macintosh icon, this emergency handbook covers the 
whole range of Macintosh problems: symptoms, causes, and 
what you can do to solve them. 640 Pages. $24.96 $22.45 


Software By Design: Creating User Friendly 
Software by Penny Bauersfeld (Series Editor: Tony 
Meadow). This excellent reference provides readers with a 
thorough how-to for designing software that is easy to 
learn, comfortable to operate and that inspires user 
confidence. Written from the perspective of Macintosh, 
but compatible with all platforms. Stresses user input 
from initial design, through prototyping, testing and 
revision. Provides tools for analyzing user needs and test 
responses. Includes exercises for sharpening user- 
oriented design skills. $29-95 $26.95 


NEW! Symantec C++ Programming for the 
Macintosh, Second Edition by Neil 
Rhodes & Julie McKeehan is the perfect introduction to 
C++ programming — the most popular programming 
language for the Mac! This updated edition is the easiest 
way to learn C++ in the Think environment, using many 
examples and hands-on coding experience. © The official 
Symantec book, developed in cooperation with the 
Product Development staff. © Provides valuable 


solutions, information, and advice for MPW programmers 
who are migrating to the Think environment. @ Disk 
includes source code from the book and example 
applications $4600 $40.50 


Taligent's Guide to Designing Programs: 
Well-Mannered Object-Oriented Design in 
C++ is the Taligent approach to object-oriented design. 
The Taligent Operating Environment is the -first 
commercial software system based entirely on object- 
oriented technology. Taligent's Guide to Designing 
Programs is a developer's-eye view of this system. It 
introduces new concepts of programming and empowers 
developers to create software more productively. Out of 
their direct experience in developing the system, the 
authors focus on global issues of object-oriented design 
and writing C++ programs, and the specific issues of 
Drogramming in the Taligent Operating Environment. 
Taligent's Guide to Designing Programs assumes the 
reader is an experienced C++ programmer, and proceeds 
from there to fully explore "the Taligent way” of 
programming. $49-60 $17.55 


NEW! The Tao of AppleScript: BMUG's 
Guide to Macintosh Scripting, 
Second Edition by Derrick Schneider & Hans 
Hansen. This updated bestseller is a complete, natural 
introduction to AppleScript programming essentials. 
Readers learn how to customize applications, automate 
tedious tasks, and create programs without having to use 
a complex programming language. @ 2 disks contain 
AppleScript, QuickTime, Stuffit Lite, ResMover, and other 
helpful utilities. Progressive structure meets the needs 
of any Mac user, regardless of experience. 
Professional instructions are mixed with practical 
examples for easy learning $29-95 $26.95 


NEW! | Teach Yourself Mac C++ Program- 
ming in 21 Days by Namir Clement 
Shammas is the easy-to-follow 21-day format teaches 
readers how to program in C++ using the Symantec C-++ 
compiler. It also shows readers how to develop GUI 
applications using the latest version of the THINK Class 
Library (TCL). © Targets Symantec C++ 7.0, one of the 
hottest programming languages and development 
environments. @ Discusses the basics of programming 
for the Mac using TCL and the Visual Architect utility. © 
Uses notes, tips, and warnings, aS well as Q&A, Quiz, 
Exercise, and Do/Don't sections to teach users the C++ 
programming language. $29-99 $26.99 


3-D Starter Kit for Macintosh by Sean 

Wagstaff. The complete reference to 3-D 
graphics on the Macintosh — ideal for beginning to 
intermediate product designers, illustrators, graphic 
designers, multimedia developers, animators, and video 
producers, as well as architects and engineers! Covers 
more than 50 major Macintosh 3-D imaging software 
packages — the most comprehensive book available. 
eLots of idea-packed examples that illustrate how 3-D 
products work — individually and together. « CD-ROM 
includes sample models, image galleries, backgrounds, 
and textures, plus 3-D software tryout versions $40-00 
$36.00 


USENET Starter Kit for Macintosh by 
Don Rittner. More than 10 million people are 


- already reading Internet newsgroups, and more are 


joining the discussions every day. USENET Starter Kit for 
Macintosh gives them valuable news readers and helps 
them take advantage of all the resources that USENET has 
to offer. ¢ Disk includes news reader programs and 
sample forums for better using USENET. © Expert 
recommendations of the top 150 newsgroups for readers 
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to explore. © Specific advice on finding the topics and 
people that users are interested in $25-00 $22.50 


Wireless For The Newton Software 

Development for Mobile Communi- 
cations by Julie McKeehan and Neil Rhodes is a book 
that picks up where Programming for the Newton left off, 
teaching the reader how to develop Newton® software on 
the Macintosh. The enclosed floppy disk provides a 
sample application, as well as a fully functional 
demonstration version of Newton Toolkit™ (NTK"), Apple 
Computer's complete development environment for the 
Newton®. Gives hands-on Newton environment training 
with sample code created specifically for the Newton®. 
The authors are external faculty at Apple Developer 
University teaching classes on programming for the 
Newton®. Programming experience is assumed, although 
not in any particular language. Enclosed is a floppy disk 
which contains source code for a Newton application, as 
well as demonstration NTK™. $384-95 $31.45 


Writing Localizable Software for the Macintosh 
by Daniel R. Carter. 469 pages. $26-85 $24.25 


THE APPLE LIBRARY 


HyperCard Stack Design Guidelines by Apple 
Computer, Inc. is an essential book for everyone who 
creates Apple HyperCard stacks, from beginners to 
commercial developers. It covers the basic principles of 
design that, when incorporated, make HyperCard stacks 
effective and usable. Topics include guidelines, 
navigation, graphic design and screen illustration, text in 
Stacks, music and sound, a sample stack development 
scenario, collaborative development, and the Stack 
Design Checklist. 240 pages. $2+05 $19.95 


Inside AppleTalk by Gursharan S. Sidhu, Richard F. 
Andrews and Alan B. Oppenheimer. Apple Computer, Inc. 
650 pages. $8495 $31.45 


Inside Macintosh: AOCE Application 
Interfaces by Apple Computer, Inc. shows how your 
application can take advantage of the system software 
features provided by PowerTalk system software and the 
PowerShare collaboration servers. Nearly every Macintosh 
application program can benefit from the addition of some 
of these features. This book shows how you can add 
electronic mail capabilities to your application, write a 
messaging application or agent, store information in and 
retrieve information from PowerShare and other AOCE 
Catalogs, add catalog-browsing and find-in-catalog 
Capabilities to your application, write templates that extend 
the Finder's ability to display information in PowerShare 
and other AOCE catalogs, add digital signatures to files or 
to any portion of a document, and establish an 
authenticated messaging connection. $40-45 $36.40 


Inside Macintosh: AOCE Service Access 
Modules by Apple Computer, Inc. describes how to write 
a software module that gives users and PowerTalk-enabled 
applications access to a new or existing mail and 
messaging service or catalog service. This book shows 
how to write a catalog service access module (CSAM), a 
messaging service access module (MSAM), and AOCE 
templates that allow a user to set up a CSAM or MSAM and 
add addresses to mail and messages. $26-05 $24.25 


NEW! Inside Macintosh: CD-ROM by Apple 
Computer, Inc. Inside Macintosh® is the 
essential reference for programmers, designers, and 
engineers for creating applications for the Macintosh 
family of computers. Inside Macintosh CD-ROM collects 
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more than 25 volumes in electronic form, including: 
QuickDraw™ GX Library, Macintosh Human Interface 
Guidelines, PowerPC System Software, Macintosh 
Toolbox Essentials and More Macintosh Toolbox, 
QuickTime and QuickTime Components. Now 
programmers will be able to access over 16,000 pages of 
the information they need directly from their computers. 
Hypertext linking and extensive cross referencing across 
volumes allows programmers to search and explore this 
library in ways that are unique to the electronic medium. 
Every Macintosh programmer will regard Inside Macintosh 
CD-ROM as their most important resource. $99.95 


Inside Macintosh: Devices by Apple Computer, 
Inc. describes how to write software that interacts with 
built-in and peripheral hardware devices. With this book,. 
you'll learn how to write and install your own device 
drivers, desk accessories, and Chooser extensions: 
communicate with device drivers using the Device 
Manager; access expansion cards using the Slot Manager; 
control SCSI devices using SCSI Manager 4.3 or the 
original SCSI Manager; communicate directly with Apple 
Desktop Bus devices; interact with the Power Manager in 
battery-powered Macintosh computers: and communicate 
with serial devices using the Serial Driver. $20-05 $26.95 


Inside Macintosh: Files by Apple Computer, Inc. 
describes the parts of the operating system that allow you 
to manage files. It shows how your application can handle 
the commands typically found in a File menu. It also 
provides a reference to the File and Alias Managers, the 
Disk Initialization and Standard File Packages. 510 pgs. 
$20-05 $26.95 


Inside Macintosh: Imaging by Apple Computer, 
Inc. covers QuickDraw and Color QuickDraw. The book 
includes general discussions of drawing and working with 
color. It describes the structures that hold images and 
image information, and the routines that manipulate them. 
lt also covers the Palette, Color, and Printing Managers, 
and the Color Picker, Color Matching, and Picture 
Utilities. $26-05 $24.25 


Inside Macintosh: Interapplication Com- 
munication by Apple Computer, Inc. shows how 
applications can work together. How your application can 
share data, request information or services, allow the user 
to automate tasks, communicate with remote databases. 
$3495 $31.45 


Inside Macintosh: Macintosh Toolbox 
Essentials by Apple Computer, Inc. covers the heart of 
the Macintosh. The toolbox enables programmers to 
create applications consistent with the Macintosh “look 
and feel”. This book describes Toolbox routines and 
shows how to implement essential user interface 
elements, Such as menus, windows, scroll bars, icons and 
dialog boxes. 880 pages. $84.05 $31.45 


Inside Macintosh: Memory by Apple Computer, 
Inc. describes the parts of the Macintosh operating 
system that allow you to manage memory. It provides 
detailed strategies for allocating and releasing memory, 
avoiding low-memory situations, reference to the Memory 
Manager, the Virtual Memory Manager, and memory- 
related utilities. 296 pages. $24.95 $22.45 


Inside Macintosh: More Macintosh Toolbox 
by Apple Computer, Inc. covers other Macintosh features 
such as how to support copy and paste, provide Balloon 
Help, play and record sound and create control panels are 
covered in this volume. The managers discussed include 
Help, List, Resource, Scrap and Sound. $34.65 $31.45 


Inside Macintosh: Networking by Apple 
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Computer, Inc. describes how to write software that uses 
Appletalk networking protocols. It describes the 
components and organization of AppleTalk and how to 
select an AppleTalk protocol. It provides the complete 
application interfaces to all AppleTalk protocols, including 
ATP (AppleTalk Transaction Protocol), DDP (Datagram 
Delivery Protocol), and ADSP (AppleTalk Data Stream 
Protocol), among others. $20-05 $26.95 


Inside Macintosh: Operating System Utilities 
by Apple Computer, Inc. describes parts of the Macintosh 
Operating System that allow you to manage various low- 
level aspects of the operating system. Everyone who 
programs the Macintosh should read this book! It will show 
you in detail how to get information about the operating 
system, manage operating system queues, handle dates and 
times, control the settings of the parameter RAM, 
manipulate the trap dispatch table, and receive and respond 
to low-level system errors. $26-05 $23.45 


Inside Macintosh: Overview by Apple Computer, 
Inc. is the first book that people who are unfamiliar with 
Macintosh programming should read. It gives an overview 
of Macintosh programming fundamentals and a road map 
to the New Inside Macintosh library. Inside Macintosh: 
Overview also covers various programming tools and 
languages, compatibility guidelines and an overview of 
considerations for worldwide development. 176 pages. 
$22.05 $20.65 


Inside Macintosh: PowerPC Numerics by 
Apple Computer, Inc. describes the floating-point 
numerics environment provided with the first release of 
PowerPC processor-based Macintosh computers. The 
numerics environment conforms to the IEEE standard 754 
for binary floating-point arithmetic. This book provides a 
description of that standard and shows how RISC 
Numerics compiles with it. This book also shows 
programmers how to create floating-point values and how 
to perform operations on floating-point values in high- 
level languages such as C and in PowerPC assembly 
language. $28-06 $26.00 


Inside Macintosh: PowerPC System 
Software by Apple Computer, Inc. describes the new 
Process execution environment and system software 
services provided with the first version of the system ° 
software for Macintosh on PowerPC computers. It 
contains information you need to know to write 
applications and other software that can run on the 
PowerPC. PowerPC System Software shows in detail how 
to make your software compatible with the new run-time 
environment provided on PowerPC-based Macintosh 
computers. It also provides a complete technical reference 
for the Mixed Mode Manager, the Code Fragment 
Manager, and the Exception Manager. $24-95 $22.45 


Inside Macintosh: Processes by Apple 
Computer, Inc. describes the parts of the Macintosh 
operating system that allow you to control the execution 
of processes and interrupt tasks. It shows in detail how 
you can use the Process Manager to get information 
about processes loaded in memory. It is also a reference 
for the Vertical Retrace, Time, Notification, Deferred Task, 
and Shutdown Managers. 208 pages. $2205 $20.65 


Inside Macintosh: QuickDraw GX Graphics by 
Apple Computer, Inc. shows readers how to create and 
manipulate the fundamental geometric shapes of QuickDraw 
GX to generate a vast range of graphic entities. It also 
demonstrates how to work with bitmaps and pictures, and 
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specialized QuickDraw GX graphic shapes. $26-95 $24.25 


Inside Macintosh®: QuickDraw” 

GX Environment and Utilities A 
companion to QuickDraw™ GX Objects, this book contains 
programming information useful to any developer writing 
QuickDraw GX applications. It describes QuickDraw GX 
memory management, error handling, debugging, and 
mathematical functions, as well aS conversion from 
QuickDraw to QuickDraw GX. $29-95 $26.95 


Inside Macintosh: QuickDraw” GX Library by 
Apple Computer, Inc. is the powerful new graphics 
architecture for the Macintosh. Far more than just a 
revision of QuickDraw, QuickDraw GX is a unified 
approach to graphics and typography that gives 
programmers unprecedented flexibility and power in 
drawing and printing all kinds of shapes, images, and text. 


Inside Macintosh: QuickDraw GX Objects by 
Apple Computer, Inc. introduces QuickDraw GX and its 
object structure, and shows programmers how to manipulate 
objects in all types of programs. $2695 $24.25 


Inside Macintosh®: QuickDraw” 

GX Printing This book is essential for any 
developer whose QuickDraw™ GX application supports 
printing. It shows how to support the new printing 
features of QuickDraw GX, including desktop printers and 
expandable printing dialog boxes. QuickDraw GX Printing 
also shows how to use printing-related objects to add 
custom panels to printing dialog boxes and to create 
custom page formats. $26-05 $24.25 


Inside Macintosh®: QuickDraw” 

GX Printing Extensions and Drivers 
Any developer who wants to create extensions to the 
application printing capabilities of QuickDraw” GX, or 
who needs to write a printing device driver that works with 
QuickDraw GX needs this book. QuickDraw GX Printing 
Extensions and Drivers describes how to create printing 
extensions and printer drivers, and provides a complete 
reference to the messages, functions, and resources that 
they use. $29-95 $26.95 


Inside Macintosh®: QuickDraw” GX 

Programmer’s Overview This book 
provides an introduction to QuickDraw” GX, providing an 
overview of the QuickDraw GX environment from a 
developer's perspective. It introduces the QuickDraw™ GX 
programming and runtime environments, the relationship 
between QuickDraw GX and the rest of the Macintosh® 
systems software and the relationship between QuickDraw 
GX and Macintosh applications. The key elements of 
QuickDraw GX programming, data structures, object 
types, and functions used most frequently by QuickDraw 
GX developers are also covered. After a general 
introduction, this book provides readers with a series of 
practical examples demonstrating how to approach 
programming with QuickDraw GX. $24.98 $22.45 


Inside Macintosh®: QuickDraw” GX 

Typography This book is essential for any 
developer who uses QuickDraw”™ GX to manipulate text. It 
shows how to use QuickDraw GX objects to handle all 
kinds of text — from plain, unstyled text to complex, 
mixed-direction and multi-language text with 
sophisticated stylistic and typographic variations. 
QuickDraw GX Typography shows how to create and 
manipulate the three different types of text shapes 
supported by QuickDraw GX including text shapes, glyph 
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shapes, and layout shapes. $20-96 $26.95 


Inside Macintosh: QuickTime by Apple 
Computer, Inc. is for anyone who wants to create 
applications that use QuickTime, the system software that 
allows the integration of video, animation, and sounds 
into applications. This book describes all of the 
QuickTime Toolbox utilities. In addition, it provides the 
information you need to compress and decompress 
images and image sequences. $29-05 $26.95 


Inside Macintosh: QuickTime Components 
by Apple Computer, Inc.covers how to use and develop 
QuickTime components such as image compressors, 
movie controllers, sequence grabbers, and video 
digitizers. $84.06 $31.45 


Inside Macintosh: Sound by Apple Computer, Inc. 
describes the parts of the Macintosh system software that 
allow you to manage sounds. It contains information that 
you need to know to write applications and other software 
that can record and play back sounds, compress and 
expand audio data, convert text to speech, and perform 
other similar operations. $26-06 $24.25 


Inside Macintosh: Text by Apple Computer, Inc. 
describes how to perform text handling, from simple 
character display to multi-language processing. The Font, 
Script, Text Services, and Dictionary Managers are all 
covered, in addition to QuickDraw Text, TextEdit, and 
International and Keyboard Resources. $39-95 $35.95 


Inside Macintosh: X-Ref by Apple 

Computer, Inc. is a fast access to all the 
information in Inside Macintosh. Inside Macintosh X Ref; 
Provides programmers with a quick and easy way to find 
the exact information they need in this definitive suite of 
books, (all 26 volumes). It is indexed by topic, volume, 
chapter, and accompanying page number. $4+0-08 
$17.95. 


Inside the Macintosh Communi- 

cations ToolBox by Apple® Computer. 
This book is the definitive reference to the Macintosh 
Communications Toolbox, an integral part of the System 
7 Macintosh Toolbox that enables developers to create 
communications applications or add communications 
features to other applications. This book describes all of 
the routines that provide programmers with standard 
access to important communications services and in 
addition enables programmers to extend the reach of the 
Macintosh into non-Apple® environments. $2405 
$22.45. 


NEW! Macintosh Programmer’s Toolbox 
Assistant CD-ROM Instant electronic 
access to Inside Macintosh essentials. Now Macintosh 
programmers can get quick access to over 4,000 Toolbox 
calls that are at the heart of Macintosh system software. The 
definitions of these data structures, resources, constants, and 
functions are documented in the Inside Macintosh series and 
are essential information for anyone developing Macintosh 
software. Macintosh Programmer's Toolbox Assistant is a 
CD-ROM that harnesses the power of one of the best search 
and viewing engines in the industry. It allows programmers 
to access the Toolbox calls quickly from their development 
environment. With hypertext links allowing programmers to 
view related topics easily. Macintosh Programmer's Toolbox 
Assistant is the ultimate electronic reference tool for 
Macintosh programmers. $99.95 


LANGUAGES 


aay BASIC for the Newton is 
BASIC for the Newton! From NS BASIC 
ee edes Corporation, it is a fully interactive 
Sa implementation of the BASIC programming 
NS BASIC language. It runs entirely on the Newton — 
no host is required. It includes a full set of functions and 
data types, hand-written input, windows, buttons and 
extensions to take advantage of the Newton environment. 
Applications can create files or access the built-in soups. 
Applications can also access the serial port for input and 
output. Work directly on the Newton, or through a 
connected Mac/PC and keyboard. NS BASIC includes a 
150 page pocket sized manual. $99 


CodeWarrior” CD by Metrowerks 
comes in two versions — Bronze and Gold. 
A\ These CDs contain the CodeWarrior 
fT A development environment including C++, C 
Meee and Pascal compilers; high-speed linkers; 
native-mode interactive debuggers; and a powerful new 
application framework called PowerPlant for rapid 
Macintosh development in C++. Bronze generates 680x0 
code. Gold generates both 680x0 and PowerPC code. All 
versions are a 3 CD subscription over a 1-year period. 
Bronze: $99, Gold: $399. Bronze comes with a 6- 
month MacTech subscription. Gold comes with a 
1-year subscription. Both at no additional charge! 


Geekware by Metrowerks is here! In high 
school, they called you a computer geek. Now, 
they work at burger joints and wear 
polyester uniforms. And you don't. Wear 
it to your favorite burger joint. $24.95 














Black Sweatshi: oc.sscscasuvoatsaueee teas $29.95 
MOUSE DAC w.c%ae et dae He keene ehh este pede $7.95 
Geekware Shirt-Cotton .............. ccc eee $24.95 
Geekware Shirt-Poly ......... 00. cc cece eee $24.95 
Baseball Gal scccvecoacs rabambaaeeean akin? $14.95 
Inside CodeWarrior 6 Book .............-005. $34.95 
Blood, Sweat & Code Black Long Sleeve Shirt .. .$19.95 
Cross Platform White Short Sleeve Shirt ........ $19.95 
Arnold Black Long Sleeve Shirt............... $19.95 
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SmalitalkAgents”™, a 
superset of the Smalltalk 
language, is fully integrated 
with Macintosh, incor- 
porating design features 
specifically for the RISC and Macintosh System 7 
architecture. SmalltalkAgents is a true object oriented 
workbench that includes an incremental and extensible 
compiler, an array of design and cross reference tools, 
preemptive interrupt driven threads and events, an 
extensive class library including classes for general 
programming, classes for the Macintosh user interface 
and classes for the Macintosh operating system. 
Integration of components in enterprise systems is 
simplified with the network, telecommunication, and inter- 
application communication libraries. The SmalitalkAgents 
extensive class library and add-on components make it 
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especially well suited as a development workbench for 
Custom applications in business, education, science, 
engineering, and academic research. $695 


Symantec C++ for Macintosh is an object 
Oriented development environment designed for 


™ professional 
SPAVINNEUTON iecintosi 
Mio programmers. 


Symantec C++ features powerful object-oriented 
development tools within a completely integrated 
environment. The C++ compiler, incremental linker, 
THINK Class Library, integrated browser, and automatic 
project management give Symantec C++ fast turnaround 
times. This product supports multiple editors and 
translators, SO you can use your favorite tools and 
resource editors as well as scripts you've written within 
the environment. And with ToolServer, you'll be able to 
customize menus and attach scripts based on Apple 
events, AppleScript, and MPW Tools. The built-in 
SourceServer provides a source code control system, 
allowing teams of programmers to solve tough problems 
faster. With SourceServer, you'll always know you're 
working on the latest version. And you'll have old 
versions at your fingertips when code “breaks” and you 
need to look back at modifications. Product Contents: 
Three high density disks, an 832-page user manual, a 
968-page THINK Class Library and a 100-page C++ 
Compiler Guide. $369 


THINK C by Symantec Corporation. THINK C is easy to 
use and highly visual, making it the No. 1 selling 
Macintosh programming environment. Enhancements 
make this product faster and more versatile than ever, 
improving your productivity with more powerful project 
management, a full set of tools, and script support for 
major script-based languages. With the THINK 
environment, you spend less time on routine 
Programming tasks due to an extremely fast compiler 
and incremental linker. In addition, the automatic project 
manager saves you time by tracking changes to your 
files and recompiling only those that have changes. All 
the tools you need — a multi-window editor, compiler, 
linker, debugger, browser, and resource editor — are 
completely integrated for speed and ease of use. One of 
the most valuable of these tools is the THINK Class 
Library, a set of program building blocks that gives you 
a head start in writing object-oriented applications. And 
with the new open architecture, you can use your favorite 
tools, resource editors, and scripts within the 
environment. THINK C is the logical next step for 
programmers who have worked in HyperCard or other 
script-based development environments. The 
environment supports AppleScript, Apple events, and 
Frontier, so you can link and automate complex, multi- 
project operations. Product Contents: Four Macintosh 
disks, an 832-page user manual, and a 568-page THINK 
Class Library Guide. $219 


THINK Pascal v. 4.0 by Symantec Corporation. 
Professionals and students will welcome this version of 
THINK Pascal. It is fully integrated for rapid turnaround 
time and lets you take advantage of System 7 capabilities. 
Features include support for large projects, enhanced 
THINK Class Library, System 7 compatibility, superior 
code generation, and smart linking. Product Contents: 
Four Macintosh disks, a 562-page user manual, and a 
498-page object-oriented programming manual. $169 
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BBEdit 3.1 from Bare Bones Software is now better 
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than ever. In addition to being Accelerated for Power 
Macintosh, this powerful, intuitive text editor offers 
integrated support for THINK C 7.0, Metrowerks 
CodeWarrior, THINK Reference 2.0 and MPW ToolServer. 
Version 3.1 adds even more capability, including "soft" 
wrapping of text on screen and numerous refinements and 
improvements to the user interface. BBEdit's many features 
include: Integrated PopupFuncs™ technology for speedy 
navigation of source code files (C, C++, Pascal, Rez, 68K 
Assembler, and Fortran), unique ‘Find Differences’ 
command (BBEdit can find differences between projects 
and folders as well as files), support for Macintosh Drag 
and Drop for editing and other common tasks, PowerTalk 
Support for reading, sending and composition of 
PowerTalk mail, scripting via any OSA compatible 
scripting language including AppleScript and Frontier 3.0, 
and fast search and replace with optional "grep" matching 
and multi-file searching. BBEdit's robust feature set and 
proven performance and reliability make it the editor of 
choice for professionals and hobbyists alike. $119 


NEW! Beautify by Barking Dog reformats C source 
code with proper loop and conditional block 
indentions, command separation and brace positioning. 
The resultant C code performs in an identical manner as 
before beautification, but the new source is easier to read 
and assists the programmer in quickly understanding the 
code. Beautify is a Drag & Drop application. Simply drop 
the source files over the Beautify icon to reformat your 
@e source. Beautify is compatible with 
| ~ CodeWarrior, MPW, Symantec and other C 
source stored as text files. $99 

Call Tree by Barking Dog Software Co is a 
quick way to understand the structure of 
complex programs. Utilizing Drag & Drop, the user can 
produce a call tree analysis of C source code files to 
assist in optimizing, structuring and a general 
understanding of software systems. Call Tree is stand- 
@e alone and works with CodeWarrior, Think C, 
F ~ Symantec, MPW and most other C source 
text files. Call Tree is simple to use and can 

save many hours of tedious work. $149. 


CLimate by Orchard Software is a command line 
interface that lets you communicate with your Macintosh 
using English commands to create, delete, rename, and 
move files and folders. It can start applications, format 
disks, restart your computer, etc. CLImate supplements 
the Finder. It includes a BASIC interpreter that lets you 
script your Macintosh without AppleScript. The interpreter 
includes advanced programming constructs: repeat loops, 
if/then/else conditionals, subroutine calls, etc... CLimate 
implements wildcard characters, enabling you to work on 
groups of files. Use CLimate instead of MPW to manage 
your projects. CLimate is an application occupying 70K 
disk space. It comes bundled with sample programs and 
full documentation. $59.95 


CMaster 2.0 by Jersey Scientific installs into THINK C 
9/ 6/7 and Symantec C++ for Macintosh, and enhances 
the editor. Use its function popup to select a function and 
CMaster takes you right to it. Other features include 
multiple clipboards and markers, a Function Prototyper, 
and a GoBack Menu which can take you back to previous 
editing contexts. Almost all features bindable to the 
keyboard, along over a hundred keyboard-only features 
like “Add New Automatic Variable.” Glossaries. 
AppleScript and ToolServer support, Macros, and External 
Tools you create too! $129.95 


Cron Manager by Orchard Software implements the 
UNIX Cron facility. It can open any Macintosh file on a 
given date and time. By creating an alias, renaming it to 
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the date and time to open, and moving it into the special 
Cron Events Folder, Cron Manager will open it. Cron 
Manager is a control panel that creates the special Cron 
Events Folder inside your System Folder. It is completely 
transparent to the user. It works like the Startup Items 
folder, only smarter. It works with any Macintosh file: if 
you can double-click to start it, Cron Manager can open 
it. $26.95. Cron Manager bundled with CLimate, $59.95 


dtF is a true relational database system for Apple 
Macintosh computers. dtF provides a powerful choice for 
developers who want to create database centered 
applications with no performance trade-offs. dtF features 
SQL, full transaction control, error recovery, single user, 
client server architecture and multi-platform support 
including DOS, Windows, OS/2 and UNIX. The C/C++ API 
is identical and fully portable cross all supported 
platforms. Third-party vendors supporting dtF will be able 
to offer a variety of advanced features and benefits to their 
customers royalty free. Tools are included for importing, 
exporting, creating and managing databases and users. 
Supported development environments include: Symantec, 
MPW, MetroWerks and more. Mac/SDK: $695. 


InstallerPack™ by StepUp Software is a package of 
several Installer “atoms” that let developers incorporate 
graphics, sounds, file compression and custom folder 
icons into installation scripts. Compression formats 
supported are Compact Pro & Diamond. Each atom also 
available separately: $219 


Last Resort Programmer’s Edition records 
every keystroke, command key and mouse event (in local 
coordinates) to a file on your hard disk. This is especially 
useful for program testing & debugging, and for technical 
Support and help desks. If something goes wrong 
(because of a power failure, system crash, forgetting to 
Save Or deleting lines) and you lose a word, phrase, or 
document you can look in the Last Resort keystroke file 
and recover what you typed. Last Resort is also useful for 
technical support personnel, when they have to ask “What 
was the last thing you did before...?” $74.95 


LJ Profiler by Lars Jordebo Datakonsult 

Supports profiling of C++ 68K and Power PC 
applications compiled with CodeWarrior, CFront or 
symantec C++. Based on active profiling, i.e. profiling code 
called at function enter and exit, the browser application 
lets you follow call chain timings in hierarchical views or 
separate windows. Collect, organize, compare and save 
profiling data from different versions of your application 
into a project. Scriptable and recordable with full access to 
most internal data structures. Optional remote profiling and 
tracking of segment and stack usage. Full source code to 
what you link into your application. $295. 


LS Object Pascal CD includes the world’s first Object 
Pascal compiler for Power Macintosh. 100% compatible 
with Apple’s MPW Pascal, LS Object Pascal combines the 
best of Apple’s native development tools with innovative 
new technology developed at Language Systems. 
Compiler options specify 68K or native PowerPC code 
generation. Included on the CD are: LS Object Pascal 
compiler, Universal Pascal Toolbox interfaces, fully loaded 
MPW 3.3.1, 68K and PowerPC source debuggers, 
PowerPC assembler, online documentation, Macintosh 
Tech Notes, and a special version of AppMaker by Bowers 
Development that generates native Pascal source code. 
The beta release includes upgrades to v1.0 when it 
becomes available. $399 


MacAnalyst/Expert, Demo $79, Product $1595 
MacAnalyst Demo $79, Product $995 MacDesigner/ 
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Expert, Demo $79, Product $1595. MacDesigner 
Demo $79, Product $995. By Excel Software. Available. Call 
for more information about these products. 


MacDesigner/Expert by Excel Software supports 
software engineering methods with the capabilities of 
MacDesigner plus multi-task design. An integrated 
requirement database provides traceability from 
requirement statements to design diagrams, code or test 
procedures. This tool is well suited to design or 
maintenance of real-time, multi-tasking software projects. 


MacA&D by Excel Software combines the capabilities 
of MacAnalyst/Expert and MacDesigner/Expert into a 
single application. It supports structured analysis and 
design, object-oriented analysis and design, real-time 
extensions, task design, data modeling, screen 
prototyping, code editing and browsing, reengineering, 
requirement traceability, and a global data dictionary. 
Demo $149, Product $2995 


MacWireFrame by Amplified 
Intelligence. Create your own virtual reality 
application with MacWireFrame, a virtual 


reality application frame work. Includes a 
complete library of object oriented graphics routines, its 
own easy to understand application frame work (similar to 
MacApp or TCL but a lot easier to understand), plus an 
example application program that lets you start solid 
modeling right away. Comes complete with fully 
documented source code. All new purchases will be 
guaranteed a $49.99 upgrade to the soon to be released, 
scriptable, MacWireFrame 5.0. Due to the overwhelming 
response the special price offer has been extended for a 
little while longer. Special Offer: $299-00 $75!!!! 


The Memory Mine” by Adianta is a stand alone 
debugging tool for Macintosh and native PowerPC. 
Programmers can monitor heaps, identify problems such 
as memory leaks, and stress test applications. Active status 
of memory in a heap is sampled on the fly: allocation in 
non-relocatable (Ptr), relocatable (Handle) and free space is 
shown, as are heap corruption, fragmentation, and more... 
Allocate, Purge, Compact, and Zap memory let users stress 
test all or part of a program. Source code is not needed to 
view heaps. It works on Macintoshes with 68020 or later 
and System 7.0 or later. $99 


NEW! Metrics by Barking Dog analyzes C source 
code and produces a set Halstead complexity 
ratings. These metrics allow developers and managers to 
quickly identify code complexity for purposes of 
estimating maintenance costs, hot spot locating, 
scheduling and assignment of the appropriate level of 
programmer for code modification. Metrics may be run 
over time to understand trends in code complexity, 
assisting management in reducing overall maintenance 
costs. Metrics is a Drag & Drop application. Simply drop 
the source files over the Metrics icon to produce a report 

@e On each source file. Metrics is compatible 
A ~ with CodeWarrior, MPW, Symantec and other 

C source stored as text files. $149 


PictureCDEF 1.3 by Paradigm 
Software is a professional-level CDEF 
for creating custom graphical buttons 
(8-64 pixels). PictureCDEF is used in products by Adobe, 
ProVue, STF Technologies and others. It is multi-monitor 
and bit-depth sensitive. The button graphic (cicn, ResEdit) 
can be changed at runtime and even animated with a call- 
back routine. Create distinct buttons in seven variations: 





ChkButton, PushPictButton and TogglePictButton. Position 
the optional button title at left, bottom or right, or follow the 
system text direction for international support. Manual, 
sample code and MacApp 3.0 support included. Full source 
code: $95.00 Object code: $45.00. 


QC™ by Onyx Technology, is a system extension that stress 
tests code during runtime for common and not-so-common 
errors. Tests include heap checks, purges, scrambles, 
handle/pointer validation, dispose/release checks, write to 
zero, de-reference zero as well as other tests like free 
memory invalidation and block bounds checking. QC is 
extremely user friendly for the non-technical tester yet offers 
an API for programmers who want precise control over 
testing. QC is Also available in Japanese. $99.95 


Qd3d/3dPane/SmartPane source code bundle by 
Vivistar Consulting. Qd3d 2.0: Full featured 3d 
3 ; ; : 

graphics. Points; lines; polygons; polyhedra; Gouraud 
shading: z-buffering: culling; depth cueing; parallel, 
perspective, and stereoscopic projections; performance 
enhancing “OnlyQD” and “Wireframe” modes; full 
clipping; pipeline access; animation and model 
interaction support; and a “triad mouse” to map 2d mouse 
movement to 3d. 3dPane 2.0: Integrates Qd3d with 
the TCL and provides a view orientation controller. 
SmartPane: Offscreen image buffering, flicker free 
animation, and QuickTime movie recording. For use with 
Qd3d/3dPane or in 2d settings. All work with C++ 
compilers or ThinkC 6. $192 


QUED/M 2.7 by Nisus Software, is a 
programmer's text editor which has defined the industry 
standard for speed and efficiency. With integrated support 
for Symantec C/C++, Metrowerks CodeWarrior, and 
MPW, QUED/M offers unrivaled usefulness for the 
Macintosh developer. In addition to supporting all the 
major development environments on the Macintosh, 
QUED/M offers dozens of powerful editing features, 
including unlimited undo and redo, UNIX style GREP 
searching, macro language, scripting, text folding, text 
sorting, file comparison and merging, Toolbox lookup, 
ten editable/appendable clipboards, line numbering, 
markers, displaying text as ASCII codes, vertical and 
horizontal screen splitting, plus much more. $149 


ScriptGen Pro” by StepUp Software is an Installer 
script generator which requires no programming or 
knowledge of Rez. Supports StepUp’s InstallerPack, Stufflt 
compression, custom packages, splash screens, network 
installs, Rez code output, importing resources, and 
AppleEvent link w/MPW: $169 : 


SoftPolish by Language Systems is a development 
tool that helps software developers avoid embarrassing 
spelling errors, detect incorrect or incompatible resources 
and improve the appearance of their Macintosh software. 
SoftPolish examines application resources and reports 
potential problems to a scrolling log. Independent of any 
programming language or environment, SoftPolish 
improves the quality of any Macintosh program. $169 


Spellswell 7 1.0.4 is an award-winning, 
comprehensive, practical spelling checker that works in 
batch mode or within applications that incorporate the 
Apple Events Word Services protocol (¢.g., Eudora, 
WordPerfect, Communicate!, and Fair Witness). 
Spellswell 7 checks for spelling errors as well as common 
typos like capitalization errors, spaces before punctuation, 
double double word errors, abbreviation errors, mixed 
case errors, extra spaces between words, a/an before 
vowel/consonant, etc... MacTech orders include developer 


kit with Writeswell Jr., a sample Apple Events Word 
Services word-processor and its source code. $74.95 


Spyer by InCider is a simple operated tool that records 
all actions (including mouse movement) you perform on a 
Macintosh computer and then replays them at your 
preferred speed. The recorded data can be saved in files 
for future use. Spyer works as a background process with 
any Macintosh application and is triggered by user 
defined Hot Keys. Spyer enables the "Continuous Redo" 
utility and is especially useful for software testing and 
demonstration. $39 


StoneTable: A \ibrary replacing all functions found in 
list manager plus: variable size columns/rows; different 
font, size, style, forecolor, backcolor per cell; sort, resize, 
move, copy, hide columns/rows; edit cells/titles in place; 
titles for columns/rows: multiple lines per cell; grid line 
pattern/color; greater than 32k data per table; up to 32k 
text per cell: support for balloon help and binary cell data. 
Versions for Think C, Think Pascal, MPW C, MPW 
Pascal, CodeWarrior C. (all prices per developer) $150 
first compiler, additional compilers $50 


StoneTable and StoneTableExtra for 
PowerPC: Same functionality as 68K libraries. 
Versions for MPW C and CodeWarrior C. Must have 68K 
libraries. (all prices per developer) StoneTable $100, 
StoneTableExtra $25 


StoneTable Extra: Additional functions for 
StoneTable. Drag selected cells within table or to other 
tables; optionally add rows as part of drag; popup menus 
or check boxes in cells; variable width grid lines; 
move/drag/resize table in window; clipboard operations 
on multiple cells. Requires StoneTable. (all prices per 
developer) $50 first compiler, additional compilers $25 


Version Control by Barking Dog Software Co. 

provides easy to use source code control for 
CodeWarrior, Think C, Symantec and other text files. Drag 
& Drop your checkins for speed. Recover any individual 
version or an entire release using the snapshot feature. 
Tracks the who, when and why of source changes and 
makes backing out changes a simple task. Version 
Control is stand-alone, requiring no other tools to 
@e operate. $199 for a single user. Multiuser 
FF ~ licenses are; 2 users $249, 3-5 users $349, 

and 6-10 users $499. 


Voodoo is a version contro! tool for the simple 

and clear management of projects in which 

files are created in numerous versions (variants and 
revisions). Voodoo allows both variant and revision 
control, and it manages not only variants and revisions of 
single files, but of a whole software project (multi files, 
multi users, multi variants, access rights, ...).The tool 
offers a neat graphical user interface and is not only 
suitable for mere source code control but can handle all 
different kinds of files with amazing compression rates: 
typical size of delta between arbitrary files 5% (in words: 
five per cent) !!!! no matter whether the files are plain text 
or any other documents — e. g. MSWord, 4D, Canvas, 
D0 FileMaker ...).Please note special prices 
"for multiple copies. single license — $ 
490 2pack—$ 300 5 pack — $ 665 
10 pack - $ 1140 20 pack — $ 2000 

Add'l pricing available on request 
















MultiState, PushButton, FlexiButton, ToggleButton, 
Want more product info? Call us at 310/575-4343. 
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"There i is a . 


3 still holding down “M”, press return, This is wi you should s see: S 








= Displaying memory from 0174: 


- 00000174 0000 0000 0040 0000 0000 0000 0000 0000 eceeve@eeeecees 


The number “00000174” is the address of the KeyMap global variables a 


et of numbers “0000 0000” is the first element of the C version of the array, 


other words it’s: “keyMapl0]”. The next set of numbers “0040 0000” is ne 
lement of the array, keyMap[1]. The next group of 8 hexadecimal digi 
ird element (keyMapI2]), and the last group of 8 hexadecimal digit 
ourth element (keyMapI3]). The series of bullets is what the array lo 
SCII form. In the second group (“0040 0000”) there is a 4 in the mi 
zeros. This is the bit that is set to 1 whenever the “M” key is he 
to see if the “M” is down from within C we will do this: Se 


ee keyMap; 
_ GetKeys ( keyMap ); 


— if( keyMap[1] & 0x00400000 ) 





{ DoMKeyDown() ; 





fe) 


hat’s all there is to it! ee 


























































































































































































































































































































































































































































































































































































































EW Tips & TIDBITS 


| Send us your tips or we'll install 
venBetterBusError on your 
machine! On the other hand, we 
might just pay you $25 for each 
tip we use, or $50 for Tip of the 
Month. You can take your award 
in goods, subscriptions or USS. 
Make sure any code compiles, 
and send tips (and where to mail 
your winnings) to all of us bere 
at editorial@xplain.com. See page 


two for our other addresses, 





ALMOST, But NoT QUITE 


In his tip (MacTech, March 1995 
issue, page 67), Jeff Beeghly assumes 
items #1 and #2 to be respectively the 
default and the cancel items. That is not 
always true: in fact these may even 
change between subsequent calls to the 
same dialog/alert if the programmer 
used “SetDialogDefaultItem” and 
“SetDialogCancelltem” before calling 
ModalDialog or set the “ALRT stage 
info” in ResEdit for the alert box. The 
safest way to find the default item is to 
look at the “aDefItem” field of the 
DialogRecord that is passed to the the 
custom modal filter procedure. 

. Moreover, I think it is best to let the 
original filter procedure track standard 
events we're not interested in, by calling 
it via “StdFilterProc” from our custom 
filter proc and then returning its return 
value to the application. 

— Luigi Belverato 
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Twelve Compilers! | 68K Mac and Power Mac. The same 

_ CodeWarrior Gold includes 12 compilers and interface compiles 68K or PPC code. 
Bronze includes 6 compilers. With our Power Features — 
Mac-hosted 68K cross compilers, you can build °C,C++ & Object Pascal 
both 68K and Power Mac apps on the Power ¢ Source Level Debugger 
Mac. Conversely, with our 68K Mac-hosted ¢ Application Framework 
Power PC cross compilers you can build 68K * 3000 pages of online documentation 
and Power Mac apps on a 68K Mac. ¢ Free tech support (with registration) 
Native IDE’s! . What's New with CodeWarrior 6 
The CodeWarrior integrated development ° Object Pascal 
environment (IDE) is native on both the °(++ Exceptions & Browser 


CodeWarrior 6 Gold 
For PPC & 68K Macintosh $399 


° Support for STL 
* Drop-In Tools Environment 


CodeWarrior 6 Bronze 


a *Raw Memory Hex Dump 
For 68K Macintosh $99 


¢ Online Reference in QuickView 





30-Day, Money-Back Guarantee. 


¢ Easy Access To Toolbox Assistant 
2 free updates, with registration. 





Native Magic Cap development environment for PowerPC and 68K 


re CodeWarrior Magic is a Macintosh-hosted toolkit for Magic Cap application development. — 


The CodeWarrior Magic/MPW toolkit includes General Magic’s object-oriented development 





tools as well as Metrowerks production-quality tools. Programmers proficient in C can 






develop and debug ona Macintosh and then download applications to a Magic Cap personal 





- communicator for final debugging. A Magic Cap simulator for Macintosh is included. 
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CodeWarrior Magic _ 2 +3 Free Updates 
| ror Power Macintosh & 08K ..........-ccccccceceseececeteretpesee ese $299 
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For more information: ¢ Metrowerks e (512) 346 1935 esales@metrowerks.com To purchase: « Metrowerks Mail Order ¢ 800-377-5416 ’ 





